INTRODUCTION 


This  manual  gives  complete  descriptions  of  all  the  publicly 
available  features  of  UNIX.  It  provides  neither  a general  ovei 
view  (see  "The  UNIX  Time-sharing  System"  for  that)  nor  details  c 
the  implementation  of  the  system  (which  remain  to  be  disclosed). 

Within  the  area  it  surveys,  this  manual  attempts  to  be  as  com- 
plete and  timely  as  possible.  A conscious  decision  was  made  to 
describe  each  program  in  exactly  the  state  it  was  in  at  the  time 
its  manual  section  was  prepared.  In  particular,  the  desire  to 
describe  sane thing  as  it  should  be,  not  as  it  is,  was  resisted. 
Inevitably,  this  means  that  many  sections  will  soon  be  out  of 
date.  (The  rate  of  change  of  the  system  is  so  great  that  a 
dismayingly  large  number  of  early  sections  had  to  be  modified 
while  the  rest  were  being  written.  The  unbounded  effort  required 
to  stay  up-to-date  is  best  indicated  by  the  fact  that  several  of 
the  programs  described  were  written  specifically  to  aid  in 
preparation  of  this  manual!) 

This  manual  is  divided  into  seven  sections: 

I.  Commands 

II.  System  calls 

III.  Subroutines 

IV.  Special  files 

V.  File  formats 

VI.  User-maintained  programs 

VII.  Miscellaneous 

Commands  are  programs  intended  to  be  invoked  directly  by  the 
user,  in  contradistinction  to  subroutines,  which  are  intended  tt> 
be  called  by  the  user's  programs.  Commands  generally  reside  irt 
directory  /bin  (for  binary  programs).  This  directory  is  searched 
automatically  by  the  command  line  interpreter.  Some  programs 
classified  as  commands  are  located  elsewhere;  this  fact  is  in<3i_ 
cated  in  the  appropriate  sections. 

* 

System  calls  are  entries  into  the  UNIX  supervisor.  In  assembly 
language , they  are  coded  with  the  use  of  the  opcode  sys  , a 
synonym  for  the  trap  instruction. 

The  special  files  section  discusses  the  characteristics  if  each 
system  "file"  which  actually  refers  to  an  I/O  device. 

The  file  formats  section  documents  the  structure  of  particular 
kinds  of  files;  for  example,  the  form  of  the  output  of  the  loader 
and  assembler  is  given.  Excluded  are  files  used  by  aly  one  com- 
mand, for  example  the  assembler's  intermediate  files 

User-maintained  programs  are  not  considered  part  ofthe  UNIX  sys- 
tem, and  the  principal  reason  for  listing  them  is  o indicate 
their  existence  without  necessarily  giving  a complte 


description.  The  author  should  be  consulted  for  information 
The  miscellaneous  section  gathers  odds  and  ends. 


Each  section  consists  of  a number  of  independent  entries  of  a 
page  or  so  each.  The  name  of  the  entry  is  in  the  upper  right 
corner  of  its  pages,  its  preparation  date  in  the  upper  left. 
Entries  within  each  section  are  alphabetized.  It  was  thought 
better  to  avoid  page  numbers,  since  it  is  hoped  that  the  manual 
will  be  updated  frequently. 

All  entries  have  a common  format. 

The  name  section  repeats  the  entry  name  and  gives  a very 
short  description  of  its  purpose. 

The  synopsis  summarizes  the  use  of  the  program  being 
described.  A few  conventions  are  used,  particularly  in  the 
Commands  section: 

Underlined  words  are  considered  literals,  and  are  typed 
just  as  they  appear. 

Square  brackets  ( [] ) around  an  argument  indicate  that  the 
argument  is  optional.  When  an  argument  is  given  as 
name  , it  always  refers  to  a file  name. 

Ellipses  "..."  are  used  to  show  that  the  previous 
argument-prototype  may  be  repeated. 

A final  convertion  is  used  by  the  commands  themselves. 

An  argument  beginning  with  a minus  sign  - is  often  tak- 
en to  mean  some  sort  of  flag  argument  even  if  it  appears 
in  a position  where  a file  name  could  appear.  Therefore, 
it  is  unwise  to  have  files  whose  names  begin  with 

The  description  section  discusses  in  detail  the  subject  at 
hand. 

The  files  section  gives  the  names  of  files  which  are  built 
into  the  program. 

A see  also  section  gives  pointers  to  related ^information. 

A diagnostics  section  discusses  the  diagnostics  that  may  be 
produced.  This  section  tends  to  be  as  terse  as  the  diagnos- 
tics themselves. 

The  bugs  section  gives  known  bugs  and  sometimes  deficien- 
cies. Occasionally  also  the  suggested  fix  is  described. 

The  owner  section  gives  the  name  of  the  person  or  persons  to 
be  consulted  in  case  of  difficulty.  The  rule  has  been  that 
the  last  one  to  modify  something  owns  it,  so  the  owner  is 
not  necessarily  the  author.  The  owner's  initials  stand  for: 


iii 


ken  K.  Thompson 

dmr  D.  M.  Ritchie 

jfo  J.  F.  Ossanna 

rhm  R.  Morris 

These  three-character  names  also  happen  to  be  UNIX  user 
ID's,  so  messages  may  be  transmitted  by  the  mail  command  or, 
if  the  addressee  is  legged  in,  by  write* 

At  the  beginning  of  this  document  is  a table  of  contents,  organ- 
ized by  section  and  alphabetically  within  each  section.  There  is 
also  a permuted  index  derived  from  the  table  of  contents.  Within 
each  index  entry,  the  title  of  the  writeup  to  which  it  refers  is 
followed  by  the  appropriate  section  number  in  parentheses.  This 
fact  is  important  because  there  is  considerable  name  duplication 
among  the  sections,  arising  principally  from  commands  which  exist 
only  to  exercise  a particular  system  call. 


This  manual  was  prepared  using  the  UNIX  text  editor  ed  and  the 
formatting  program  roff . 
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ar  — archive 

ar  key  afile  name1  ... 

ar  maintains  groups  of  files  combined  into  a sin- 
gle archive  file,  its  main  use  is  to  create  and 
update  library  files  as  used  by  the  loader.  It 
can  be  used,  though,  for  any  similar  purpose, 

key  is  one  character  from  the  set  dr tux,  option- 
ally concatenated  with  v.  afile  is  the  archive 
file.  The  names  are  constituent  files  in  the 
archive  file.  The  meanings  of  the  key  characters 
are: 

d means  delete  the  named  files  from  the  archive 
file. 

r means  replace  the  named  files  in  the  archive 
file.  If  the  archive  file  does  not  exist,  r will 
create  it.  If  the  named  files  are  not  in  the 
archive  file,  they  are  appended. 

t prints  a table  of  contents  of  the  archive  file. 
If  no  names  are  given,  all  files  in  the  archive 
are  tabled.  If  names  are  given,  only  those  files 
are  tabled. 

u is  similar  to  r except  that  only  those  files 
that  have  been  modified  are  replaced.  If  no 
names  are  given,  all  files  in  the  archive  that 
have  been  modified  will  be  replaced  by  the  modi- 
fied version. 

x will  extract  the  named  files.  If  no  names  are 
given,  all  files  in  the  archive  are  extracted. 

In  neither  case  does  x alter  the  archive  file. 

v means  verbose.  Under  the  verbose  option,  ar 
gives  a file- by-file  description  of  the  making  of 
a new  archive  file  from  the  old  archive  and  the 
constituent  files.  The  following  abbreviations 
are  used: 

c copy 
a append 
d delete 
r replace 
x extract 

/tmp/vtma,  vtmb  ...  temporary 

Id 

^Bad  usage",  "afile  — Mnot  in  archive  format"^ 
cannot  open  temp  file",  "name  — cannot  open  , 
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„name  — phase  error  , name  — cannot  create”, 
.no  archive  file  cannot  create  archive  file  , 
name  — not  found  . 

Option  _1  (table  with  more  information)  should  be 
implemented. 

There  should  be  a way  to  specify  the  placement  of 

3 Kl  OUT  f i 1 a < n aw  a A-  *1 » jl  _»  _ 

~ '-***  ui  v-iiAvc*  uui.  i.  cu  u- ±y  9 it  is 

placed  at  the  end. 
ken , dmr 
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NAME  as  — assembler 

SYNOPSIS  .as  name1  ... 

DESCRIPTION  as  assembles  the  concatenation  of  name1  , ....  ajs 

is  based  on  the  DEC-provided  assembler  PAL-1 1R 
[references]  , although  it  was  coded  locally. 
Therefore,  only  the  differences  will  be  recorded. 

Character  changes  are: 

for  use 

§ * 

# $ 

5 / 

In  as,  the  character  is  a logical  new  line; 

several  operations  may  appear  on  one  line  if 
separated  by  ";".  Several  new  expression  opera- 
tors have  been  provided: 

right  shift  (logical) 
left  shift 
mult ipl icat ion 
division 

remainder  (no  longer  means  "register  ) 
one's  complement 
parentheses  for  grouping 
result  has  value  of  left,  type  of  right 

For  example  location  0 (relocatable)  can  be  writ- 
ten -0\  ; another  way  to  denote  register  2 is 
"2~r0" . 

All  of  the  preceding  operators  are  binary;  if  a 
left^ogerand  is  missing,  it  is  taken  to  be  0. 

The  " l operator  adds  its  left  operand  to  the 
one's  complement  of  its  right  operand. 

There  is  a conditional  assembly  operation  code 
different  from  that  of  PAL-1 1R  (whose  condition- 
als are  not  provided): 

.if  expression 
• • • 

. end if 

If  the  expression  evaluates  to  non-zero  4 the  sec- 
tion of  code  between  the  ".if"  and  the  . endif" 
is  assembled;  otherwise  it  is  ignored.  ”.if"s 
may  be  nested. 

Temporary  labels  like  those  introduced  by  Knuth 
[reference]  may  be  employed.  A temporary  label 
is  defined  as  follows: 


\> 

\< 

* 

V 

% 

! 
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n: 

where  n is  a digit  0 ...  9.  Synbols  of  the  form 
nf  refer  to  the  first  label  ui  following  the 
use  of  the  symbol;  those  of  the  form  "nb  refer 
to  the  last  n:  ” . The  same  "n"  may  be  used  many 
times.  Labels;  of  this  form  are  less  taxing  both 
on  the  imagination  of  the  programmer  and  on  the 

1 4-  aVl  a ei«,ario  /■*>  *F  4*V»o  aeeomKl  or 

J.  O w 4.  w*  w*  • 

The  PAL-1 1R  opcodes  ".eot"  and  ".end"  are  redun- 
dant and  are  omitted. 

The  symbols 

rO  ...  r5 

sp 

pc 

v.  . V ) ' i/  /#.  ?' 

* (**  a *- 1 c \ ■ r ! f°*t / 

mul  ^ 
lsh 
ash  , 
no  r . ' 
csw 


are  gredefined  with  appropriate  values.  The  sjrcn- 
bol  csw"  refers  to  the  console  switches.  .. 
is  the  relocation  constant  and  is  added  to  each 
relocatable  symbol;  normally  it  is  40000(8);  it 
may  be  changed  to  assemble  a section  of  code  at  a 
location  different  from  that  in  which  it  will  be 
executed. 

It  ig  illegal  to  assign  a value  to  "."  less  than 
its  current  value. 

The  new  opcode  "sys"  is  used  to  specify  system 
calls.  Names  for  system  calls  are  predefined. 

See  the  section  on  system  calls  for  their  names. 

Strings  of  characters  may  be  assembled  in  a way 
more  convenient  than  PAL-11 's  .ascii  operation 
(which  is,  therefore,  omitted).  Strings  are 
included  between  the  string  quotes  "<"  and  ">": 

<here  is  a string> 

Escape  sequences  exist  to  enter  non  graphic  and 
other  difficult  characters.  These  sequences  are 
also  effective  in  single  and  double  character 
constants  introduced  by  single  (')  and  double  ( ) 

quotes  respectively. 
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use  for 

\n  newline  (012) 
\0  NULL  ( 000 ) 

\>  > 

\t  TAB  (011 ) 

\\  \ 


FILES 


SEE  ALSO 
DIAGNOSTICS 


The  binary  output  of  the  assembler  is  placed  on 
the  file  a. out"  in  the  current  directory,  a. out 
also  contains  the  symbol  table  from  the  assembly 
and  relocation  bits.  The  output  of  the  assembler 
is  executable  immediately  if  the  assembly  was 
error-free  and  if  there  were  no  unresolved  exter- 
nal references.  The  link  editor  Id  may  be  used 
to  combine  several  assembly  outputs  and  resolve 
global  symbols. 

The  multiple  location  counter  feature  of  PAL11R 
is  not  supported. 


The  assembler  does  not  produce  a listing  of  the 
source  program.  This  is  not  a serious  drawback; 
the  debugger  db  discussed  below  is  sufficiently 
powerful  to  render  a printed  octal  translation  of 
the  source  unnecessary. 


/etc/as2 
a . tmp 1 
a. tmp2 
a.tmp3 
a. out 


pass  2 of  the  assembler 

temporary 

temporary 

temporary 

object 


Id,  nm,  sh,  un,  db,  a. out  (format  of  output) 


When  an  input  file  cannot  be  read,  its  name  fol- 
lowed by  a question  mark  is  typed  and  assembly 
ceases. 


When  syntactic  or  semantic  errors  occur,  a 
single-character  diagnostic  is  typed  out  together 
with  the  line  number  and  the  file  name  in  which 
it  occurred.  Errors  in  pass  1 cause  cancellation 
of  pass  2.  The  possible  errors  are: 

) parentheses  error 

] parentheses  error 

* Indirection  ("*")  used  illegally 

A error  in  Address 

B Branch  instruction  has  too  remote  an  ad- 

dress 

E error  in  Expression 

F error  in  local  ("f"  or  "b")  type  symbol 
G Garbage  (unknown)  character 

M Multiply  defined  symbol  as  label 

0 Odd — word  quantity  assembled  at  odd 
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BUGS 

OWNER 


address 

P Phase  error — different  in  pass  2 from 

pass  1 value 
R Relocation  error 

U Undefined  symbol 

X syntax  error 

Symbol  table  overflow  is  not  checked, 
dmr 
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NAME  B — language 

SYNOPSIS  sh  rc  /usr/b/rc  name 

DESCRIPTION  B is  a language  suitable  for  system  programming. 

It  is  described  is  a separate  publication  B 
reference  manual. 

O r»ann  oH  cViDl  1 eomian  A /n  or  /Vs/r^  t.t<  1 1 _ 

• »•  '■*»*•  %->■»-».  A •-»  Ait  / M W4i  f ±4/  v.  TV  J.  x X V.VUI-- 

pile  the  program  name.b  into  the  executable  file 
a. out.  It  involves  running  the  B compiler,  the  B 
assembler,  the  assembler  and  the  link  editor. 

The  process  leaves  the  files  name.i  and  name.s  in 
the  current  directory. 

FILES  name.b,  name.i,  name.s. 

SEE  ALSO  /etc/bc,  /etc/ba,  /etc/brtl,  /etc/brt2, 

/etc/bilib,  /etc/libb.a,  B reference  manual. 

DIAGNOSTICS  see  B reference  manual 

BUGS  There  should  be  a B command. 

OWNER  ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


bas  — basic 
bas  [file] 

bas  is  a dialect  of  basic.  If  a file  argument  is 
provided,  the  file  is  used  for  input  before  the 
console  is  read. 

Kac  e 1 A mao  /vP  ^ vm  • 

Wi.  W11U  lilt 


statement 
integer  statement 

Integer  numbered  statements  (known  as  internal 
statements)  are  storied  for  later  execution.  They 
are  stored  in  sorted  ascending  order.  Non- 
number ed  statements  are  immediately  executed. 

The  result  of  an  immediate  expression  statement 
(that  does  not  have  '='  as  its  highest  operator) 
is  printed. 

Statements  have  the  following  syntax:  ( expr  is 
short  for  expression) 

expr 

The  expression  is  executed  for  its  side 
effects  (assignment  or  function  call)  or 
for  printing  as  described  above. 

done 

Return  to  system  level. 
draw  expr  expr  expr 

draw  is  used  to  draw  on  a 611-type  storage 
scope  through  a TSP-1  plotter  interface. 

The  coordinates  of  the  scope  face  are  zero 
to  one  in  both  the  x and  y directions. 

(Zero, zero  being  the  lower  left  corner.) 

The  expressions  are  evaluated  and  designat- 
ed X,  Y,  and  Z.  A line  is  drawn  from  the 
previous  X,  Y to  the  new  X,  Y.  If  Z is 
non-zero,  the  line  is  visible,  otherwise 
the. line  is  invisible. 

for  name  = expr  expr  statement 
for  name  = expr  expr 
• • • 
next 

The  for  statement  repetatively  executes  a 
statement  (first  form)  or  a group  of  state- 
ments (second  form)  under  control  of  a 
named  variable.  The  variable  takes  on  the 
value  of  the  first  expression,  then  is 
incremented  by  one  on  each  loop,  not  to 
exceed  the  value  of  the  second  expression. 
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goto  expr 

The  expression  is  evaluated,  truncated  to 
an  integer  and  execution  goes  to  the 
corresponding  integer  number eu  statment. 

If  executed  from  immediate  mode,  the  inter- 
nal statements  are  compiled  first. 


if  expr  statement 

mV  A 4 S A 1 ^ 4 

me  ouci  tcmciiv.  j.  o CACV.UV.C.U  mj~ 

evaluates  to  non-zero. 


AV  A r1  A AO  A AVN 
XVU 


list  [expr  [expr]] 

list  is  used  to  print  out  the  stored  inter- 
nal statements.  If  no  arguments  are  given, 
all  internal  statements  are  printed.  If 
one  argument  -is  given,  only  that  internal 
statement  is  listed.  If  two  arguments  are 
given,  all  internal  statements  inclusively 
between  the  arguments  are  printed. 


print  expr 

The  expression  is  evaluated  and  printed. 


return  expr 

The  expression  is  evaluated  and  the  result 
is  passed  back  as  the  value  of  a function 
call. 


run 

The  internal  statements  are  compiled.  The 
symbol  table  is  re-initialized.  The  random 
number  generator  is  re-set.  Control  is 
passed  to  the  lowest  numbered  internal 
statement . 

Expressions  have  the  following  syntax: 
name 

A name  is  used  to  specify  a variable. 

Names  are  composed  of  a letter  ('a'  - ' z' ) 
followed  by  letters  and  digits.  The  first 
four  characters  of  a name  are  significant. 

number 

A number  is  used  to  represent  a constant 
value.  A number  is  composed  of  digits,  at 
most  one  decimal  point  and  possibly  a 

scale  factor  of  the  form  e digits  or  e- 
digits. 

1 expr  1 

Parentheses  are  used  to  alter  normal  order 
of  evaluation. 

expr  op  expr 

Common  functions  of  two  arguments  are 
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abbreviated  by  the  two  arguments  separated 
by  an  operator  denoting  the  function.  A 
complete  list  of  operators  is  given  below. 

expr  £ [expr  [A  expr  ...]]  £ 

Functions  of  an  arbitrary  nunber  of  argu- 
ments can  be  called  by  an  expression  fol- 
lowed by  the  arguments  in  parentheses 
separated  by  commas.  The  expression  evalu- 
ates to  the  line  number  of  the  entry  of  the 
function  in  the  internally  stored  state- 
ments. This  causes  the  internal  statements 
to  be  compiled.  If  the  expression  evalu- 
ates negative,  an  built in  function  is 
called.  The  list  of  builtin  functions 
appears  below. 

name  £ expr  expr  ...]  £ 

Arrays  are  not  yet  implemented. 

The  following  is  the  list  of  operators: 


- is  the  assignment  operator.  The  left 
operand  must  be  a name  or  an  array  element. 
The  result  is  the  right  operand.  Assign- 
ment binds  right  to  left,  all  other  opera- 
tors bind  left  to  right. 


& | 

& (logical  and)  has  result  zero  if  either 
of  its  arguments  are  zero.  It  has  result 
one  if  both  its  arguments  are  non-zero.  £ 
(logical  or)  has  result  zero  if  both  of  its 
arguments  are  zero.  It  has  result  one  if  ' 
either  of  its  arguments  are  non-zero. 

<<=>>=  ==  <> 

The  relational  operators  (<  less  than,  <= 
less  than  or  equal,  > greater  than,  >= 
greater  than  or  equal,  ==  equal  to,  <>  not 
equal  to)  return  one  if  their  arguments  are 
in  the  specified  relation.  They  return 
zero  otherwise.  Relational  operators  at 
the  same  level  extend  as  follows:  a>B>c  is 
the  same  as  a>b&b>c. 


Add  and  subtract . 


* / 

Multiply  and  divide. 


Exponeniation 
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FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


The  following  is  a list  of  builtin  functions: 
arg 


Ar/> r t $ \ ^ e 

parameter 
call . 

exp 

■Rxnfxl  is 

t » - - ' — 

log 

Log(x)  is 

sin 

Sin(x)  is 

cos 

Cos(x)  is 

atn 

Atn(x)  is 
mented. ) 

rnd 


the  value  of  the  ith  actual 
on  the  current  level  of  function 

the  exDonential  function  of  x. 

* 

the  logarithm  bas  e of  x. 

the  sine  of  x (radians). 

the  cosine  of  x (radians). 

the  arctangent  of  x.  (Not  imple- 


Rnd()  is  a uniformly  distributed  random 
number  between  zero  and  one. 


expr 

Expr()  is  the  only  form  of  prpgram  input. 

A line  is  read  from  the  input  and  evaluated 
as  an  expression.  The  resultant  value  is 
returned. 


int 

Int(x)  returns  x truncated  to  an  integer, 
/tmp/btma , btmb  ...  temporary 


Syntax  errors  cause  the  incorrect  line  to  be 
typed  with  an  underscore  where  the  parse  failed. 
All  other  diagnostics  are  self  explanatory. 

Arrays  []  are  not  yet  implemented.  In  general, 
program  sizes,  recursion,  etc  are  not  checked, 
and  cause  trouble. 


OWNER 


ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


bed  — binary  coded  decimal  conversion 
bed  [ string  ] 

bed  will  convert  a string  into  GECOS  card  code. 
If  no  argument  string  is  provided,  bed  will  read 
a line  and  convert  it. 


OWNER 


dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


boot  — reboot  system 
/etc/boot 

boot  logically  a command,  and  is  kept  in  /etc 
only  to  lessen  the  probability  of  its  being  in- 
voked by  accident  or  from  curiosity.  It  reboots 
the  system  by  jumping  to  the  read-only  memory, 

r*  a < r\  e a ■!  oV*  rtmrrram' 

*t  A IX  W|1  W uxi  A W *— *■  X WJ  V fcTWW  W k/J.  W X VWII  • 


boot  procedure 


Should  obviously  not  be  executable  by  the  general 
user.  Also,  it  should  reboot  in  a more  direct 
manner.  The  mechanism  invoked  by  jumping  to  the 
ROM  loader  is  sensitive  to  the  contents  of  the 
console  switches,  which  makes  the  whole  procedure 
even  more  dangerous. 

Rather  than  jumping  to  the  ROM,  boot  should  simu- 
late the  ROM  action  with  173700  in  the  switches. 
In  this  manner,  It  may  be  used  when  the  switches 
are  not  set,  and  even  in  installation  without  a 
ROM. 


OWNER 


ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 
OWNER 


cat  — concatenate  and  print 
cat  file1  ... 

cat  reads  each  file  in  sequence  and  writes  it  on 
the  standard  output  stream.  Thus: 

cat  file 

is  about  the  easiest  way  to  print  a file.  Also: 
cat  fllel  f ile2  >file3 

is  about  the  easiest  way  to  concatenate  files. 

If  no  input  file  is  given  cat  reads  from  the 
standard  input  file. 

pr,  cp 

none;  if  a file  cannot  be  found  it  is  ignored, 
ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


chdir  — change  working  directory 
chdir  directory 

directory  becomes  the  new  working  directory. 

Because  a new  process  is  created  to  execute  each 
command,  chdir  would  be  ineffective  if  it  were 
written  as  a normal  command.  It  is  therefore 
recognized  and  executed  by  the  Shell. 


sh 


ken , dmr 


OWNER 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


check  — file  system  consistency  check 

check  [ filesystem  [ blockno1  ...  ] ] 

checfc  will  examine  a file  system,  build  a bit  map 
of  used  blocks,  and  compare  this  bit  map  against 
the  bit  map  maintained  on  the  file  system.  If 
the  file  system  is  not  specified,  a check  of  both 
/ /ucv/iav  x H pexxorinea*  uucput  in— 

eludes  the  number  of  files  on  the  file  system, 
the  number  of  these  that  are  ' large* , the  number 
of  used  blocks,  and  the  number  of  free  blocks. 

/ d ev/ r f 0 , / dev/ rkO 


find 


Diagnostics  are  produced  for  blocks  missing, 
duplicated,  and  bad  block  addresses.  Diagnostics 
are  also  produced  for  block  numbers  passed  as 
parameters,  in  each  case,  the  block  number, 
i-number,  and  block  class  (i  = inode,  x indirect, 
f free)  is  printed.  “ 

The  checking  process  is  two  pass  in  nature.  If 
checking  is  done  on  an  active  file  system,  ex- 
traneous diagnostics  may  occur. 

The  swap  space  on  the  RF  file  system  is  not  ac- 
counted for  and  will  therefore  show  up  as  'miss- 
ing'. 


ken,  dmr 
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NAME  chmod  — change  mode 

SYNOPSIS  chmod  octal  file^  ... 

DESCRIPTION  The  octal  mode  replaces  the  mode  of  each  of  the 

files.  The  mode  is  constructed  from  the  OR  of 
the  following  modes: 

r\4  — .-v  ~ 

w I W X X U XWX  IlUU  — UWilCi 

02  read  for  non-owner 
04  write  for  owner 
10  read  for  owner 
20  executable 
40  set-UID 

Only  the  owner  of  a file  may  change  its  mode. 

FILES 

SEE  ALSO  stat,  Is 

DIAGNOSTICS  ? 

BUGS 

OWNER  ken,  dmr 
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NAME  chown  — change  owner 

SYNOPSIS  chown  owner  file^  ... 

DESCRIPTION  owner  becomes  the  new  owner  of  the  files.  The 

owner  may  be  either  a decimal  UID  or  a name  found 
in  /etc/uids. 

Only  the  owner  of  a file  is  allowed  to  change  the 
owner.  It  is  illegal  to  change  the  owner  of  a 
file  with  the  set-user-ID  mode. 

PILES  /etc/uids 

SEE  ALSO  st at 

DIAGNOSTICS  ? 

BUGS 

OWNER  ken,  dmr 
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NAME  cmp  — compare  two  files 

SYNOPSIS  cmp  f ile1  file, 

DESCRIPTION  The  two  files  are  compared  for  identical  con- 
tents. Discrepancies  are  noted  by  giving  the 
offset  and  the  differing  words. 

FILES 

SEE  ALSO 

DIAGNOSTICS  Messages  are  given  for  inability  to  open  either 

argument,  premature  EOF  on  either  argument,  and 
incorrect  usage. 

BUGS  If  the  two  files  differ  in  length  by  one  byte, 

the  extra  byte  does  not  enter  into  the  compari- 
son . 

OWNER  dmr 
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NAME 

cp  — copy 

SYNOPSIS 

2E  fAl®2,j  ^^^22  ••• 

DESCRIPTION 

Files  are  taken  in  pairs;  the  first  is  opened  for 
reading,  the  second  created  mode  17.  Then  the 
first  is  copied  into  the  second. 

FILES 

— 

SEE  ALSO 

cat , pr 

DIAGNOSTICS 

Error  returns  are  checked  at  every  system  call, 
and  appropriate  diagnostics  are  produced. 

BUGS 

The  second  file  should  be  created  in  the  mode  of 
the  first. 

A directory  convention  as  used  in  mv  should  ba 
adopted  to  cp. 

OWNER 

ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

r*  T?X?  A T r« 

OLD  nUO'J 

DIAGNOSTICS 

BUGS 

OWNER 


date  — print  the  date 
date 

The  current  date  is  printed  to  the  second. 

-.4-  ^ 

OUOL  C 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


db  — debug 

db  [ core  [ namelist  ] ] 

Unlike  many  debugging  packages  (including  dec's 
ODT , on  which  db  is  loosely  based)  db  is  not 
loaded  as  part  of  the  core  image  which  it  is  used 
to  examine;  instead  it  examines  files.  Typical- 
ly, the  file  will  be  either  a core  image  produced 
after  a fault  or  the  binary  output  of  the  assem- 
bler Core  is  the  file  being  debugged;  if  omit- 
ted core  is  assumed.  namelist  is  a file  con- 
taining a symbol  table.  If  it  is  omitted,  a. out 
is  the  default.  If  no  appropriate  name  list  file 
can  be  found,  db  can  still  be  used  but  some  of 
its  symbolic  facilities  become  unavailable. 

The  format  for  most  db  requests  is  an  address 
followed  by  a one  character  command. 

Addresses  are  expressions  built  up  as  follows: 

1 . A name  has  the  value  assigned  to  it  when 
the  input  file  was  assembled.  It  may  be 
relocatable  or  not  depending  on  the  use  of 
the  name  during  the  assembly. 

2.  An  octal  number  is  an  absolute  quantity 
with  the  appropriate  value. 

3.  An  octal  number  immediately  followed  by  "r" 
is  a relocatable  quantity  with  the  ap- 
propriate value. 

4.  The  symbol  . indicates  the  current 
pointer  of  db.  The  current  pointer  is  set 
by  many  db  requests. 

5.  Expressions  separated  by  "+"  or  (blank) 

are  expressions  with  value  equal  to  the  sum 
of  the  components.  At  most  one  of  the  com- 
ponents may  be  relocatable. 

6.  Expressions  separated  by  form  an  ex- 
pression with  value  equal  to  the  difference 
to  the  components.  If  the  right  component 
is  relocatable,  the  left  component  must  be 
relocatable. 

7.  Expressions  are  evaluated  left  to  right. 
Names  for  registers  are  built  in: 

rO  ...  r5 

sp 

pc 
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ac 

mq 

These  may  be  examined.  Their  values  are  deduced 
from  the  contents  of  the  stack  in  a core  image 
file.  They  are  meaningless  in  a file  that  is  not 
a core  image. 

If  no  address  is  given  for  a command,  the  current 
address  (also  specified  by  ".")  is  assumed.  In 
general,  points  to  the  last  word  or  byte 

printed  by  db. 

There  are  db  commands  for  examining  locations 
interpreted  as  octal  numbers,  machine  instruc- 
tions, ASCII  characters,  and  addresses.  For 
numbers  and  characters, . either  bytes  or  words  may 
be  examined.  The  following  commands  are  used  to 
examine  the  specified  file. 

/ The  addressed  word  is  printed  in  octal. 

\ The  addressed  byte  is  printed  in  octal. 

The  addressed  word  is  printed  as  two  ASCII 
char  act  ers . 

' The  addressed  byte  is  printed  as  an  ASCII 
character. 

* The  addressed  word  is  multiplied  by  2,  then 
printed  in  octal  (used  with  B programs, 
whose  addresses  are  word  addresses). 

? The  addressed  word  is  interpreted  as  a 

machine  instruction  and  a symbolic  form  of 
the  instruction,  including  symbolic  ad- 
dresses, is  printed.  Usually,  the  result 
will  appear  exactly  as  it  was  written  in 
the  source  program. 

& The  addressed  word  is  interpreted  as  a sym- 
bolic address  and  is  printed  as  the  name  of 
the  symbol  whose  value  is  closest  to  the 
addressed  word,  possibly  followed  by  a 
signed  offset. 

<nl>  (i.  e. , the  character  "new  line")  This 
command  advances  the  current  location 
counter  and  prints  the  resulting  loca- 
tion in  the  mode  last  specified  by  one  of 
the  above  requests. 

This  character  decrements  and  prints 
the  resulting  location  in  the  mode  last 
selected  one  of  the  above  requests.  It  is 
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a converse  to  <nl>. 

It  is  illegal  for  the  word-oriented  commands  to 
have  odd  addresses.  The  incrementing  and  decre- 
menting of  done  by  the  <nl>  and  requests  is 
by  one  or  two  depending  on  whether  the  last  com- 
mand was  word  or  byte  oriented. 

The  address  portion  of  any  of  the  above  commands  . 
may  be  followed  by  a comma  and  then  by  an  expres- 
sion. In  this  case  that  number  of  sequential 
words  or  bjftes  specified  by  the  expression  is 
printed.  ."  is  advanced  so  that  it  points  at 
the  last  thing  printed. 

There  are  two  commands  to  interpret  the  value  of 
expressions. 

= When  preceded  by  an  expression,  the  value 
of  the  expression  is  typed  in  octal.  When 
not  preceded  by  an  expression,  the  value  of 
is  indicated.  This  command  does  not 
change  the  value  of 

t An  attempt  is  made  to  print  the  given  ex- 
pression as  a symbolic  address.  If  the 
expression  is  relocatable,  that  symbol  is 
found  whose  value  is  nearest  that  of  the 
expression,  and  the  symbol  is  typed,  fol- 
lowed by  a sign  and  the  appropriate  offset. 
If  the  value  of  the  expression  is  absolute, 
a symbol  with  exactly  the  indicated  value 
is  sought  and  printed  if  found;  if  no 
matching  symbol  is  discovered,  the  octal 
value  of  the  expression  is  given. 

The  following  command  may  be  used  to  patch  the 
file  being  debugged. 

! This  command  must  be  preceded  by  an  expres- 
sion. The  value  of  the  expression  is 
stored  at  the  location  addressed  by  the 
current  value  of  The  opcodes  do  not 

appear  in  the  symbol  table,  so  the  user 
must  assemble  them  by  hand. 


The  following  command  is  used  after  a fault  has 
caused  a core  image  file  to  be  produced. 

$ causes  the  contents  of  the  general  regis- 
ters and  several  other  registers  to  be 
printed  both  in  octal  and  symbolic  format. 
The  values  are  as  they  were  at  the  t.ime  of 
the  fault. 
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The  only  way  to  exit  from  db  is  to  generate  an 
end  of  file  on  the  typewriter  (EOT  character). 

PTT  PC 

x.  jk.  xjj-ixj  - \ 

SEE  ALSO  as;  core  for  format  of  core  image. 

DIAGNOSTICS  File  not  found" m if  the  first  argument  cannot  be 

read;  otherwise  ?". 

BUGS  Really,  db  should  know  about  relocation  bits, 

floating  point  operations,  and  PDP11/45  instruc- 
t ion  s . 

OWNER  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


dbppt  — dump  binary  paper  tape 
dbppt  name  [ output  ] 

d]2gpt  produces  binary  paper  tape  in  UNIX  standard 
fui. mat , which  includes  checksums  and  a zero- 
suppression  feature.  File  name  is  dumped;  if  the 
output  argument  is  not  given,  output  goes  to 
/dev/ppt. 

/dev/ppt 

^??P,P.fc  to  reload  the  tapes,  bppt  for  binary  paper 
tape  format. 

? 


ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


dc  — desk  calculator 
dc 

dc  is  an  arbitrary  precision  integer  arithmetic 
package.  The  overall  structure  of  dc  is  a stack- 
ing (reverse  Polish)  calculator.  The  following 
constructions  are  recognized  by  the  calculator: 

number 

The  value  of  the  number  is  pushed  on  the 
stack.  If  the  number  starts  with  a zero,  it 
is  taken  to  be  octal,  otherwise  it  is  decimal. 

± - 1 Z % 

The  top  two  values  on  the  stack  are  added  (+), 

, subtracted  (-),  multiplied  (*),  divided  {/_) , 
or  remaindered  (&).  The  two  entries  are 
poppped  off  of  the  stack,  the  result  is  pushed 
on  the  stack  in  their  place. 


The  top  of  the  stack  is  popped  and  stored  into 
a register  named  x,  where  x may  be  any  charac- 
ter. 


lx 

The  value  in  register  x is  pushed  on  the 
stack.  The  register  x is  not  altered. 

d 

The  top  value  on  the  stack  is  pushed  on  the 
stack.  Thus  the  top  value  is  duplicated. 

£ 

The  top  value  on  the  stack  is  printed  in  de- 
cimal. The  top  value  remains  unchanged. 

f 

All  values  on  the  stack  are  popped  off  and 
printed  in  decimal. 

r 

All  values  on  the  stack  are  popped. 

a 

exit. 

h 

print  brief  synopsis  of  commands  to  dc. 

new-line 

space 

ignor  ed . 


An  example  to  calculate  the  monthly,  weekly  and 
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hourly  rates  for  a $10 ,000/ year  salary. 


1 0000 
a 

1 V-/  V-/  " 

(now  in  cents) 

dsa 

(non-destructive  store) 

12/ 

(pennies  per  month) 

la52/ 

(pennies  per  week) 

dIO* 

(deci-pennies  per  week) 

/ 

( n ■)  oc  nor  lr^  nr  ^ 

f 

(print  all  results) 

(3)  512 
(2)  19230 

( 1 ) 83333 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


? (x)  for  unrecognized  character  x. 

% doesn't  work  correctly. 

ken 
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NAME  df  — disk,  free 

SYNOPSIS  df  [ filesystem  ] 

DESCRIPTION  df  prints  out  the  number  of  free  blocks  available 

on  a file  system.  If  the  file  system  is  unspeci- 
fied, the  free  space  on  /dev/rfO  and  /dev/rkO  is 
printed. 

FILES  /dev/rfO,  /dev/rkO 

SEE  ALSO  check 

DIAGNOSTICS 
BUGS 

OWNER  ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


dsw  — delete  interactively 
dsw  [ directory  ] 

Ftor  each  file  in  the  given  directory  if  not 

specified)  dsw  types  its^narae.  If  y is  typed, 
the  file  is  deleted;  if  "x" , dsw  exits;  if  any- 
thing else,  the  file  is  not  removed. 


rm 


The  name  "dsw"  is  a carryover  from  the  ancient 
past.  Its  etymology  is  amusing  but  the  name  is 
nonetheless  ill-advised. 

dmr , ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


OWNER 


dtf  — DECtape  format 
/etc/dtf 

dtf  will  write  timing  tracks,  mark  tracks  and 
block  numbers  on  a virgin  DECtape.  The  format  is 
DEC  standard  of  578  blocks  of  256  words  each. 

The  end  zones  are  a little  longer  than  standard 
DEC. 

Before  use,  the  tape  to  be  formatted  should  be 
mounted  on  drive  0.  The  'wall'  and  'wtm' 
switches  should  be  enabled.  After  the  tape  is 
formatted,  the  switches  should  be  disabled  to 
prevent  damage  to  subsequent  tapes  due  to  a con- 
troller logic  error. 


sdate 

is  typed  for  any  error  detected. 

This  program  does  physical  I/O  on  drive  0.  The 
processor  priority  is  set  very  high  due  to  very 
stringent  real  time  requirements.  This  means 
that  all  time  sharing  activities  are  suspended 
during  the  formatting  (about  1.5  minutes)  The 
real  time  clock  will  also  be  slow. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


du  — summarize  disk  usage 
du  [ ^ ] [ name  ...  ] 

du  gives  the  number  of  blocks  contained  in  all 
files  and  { recursively ) directories  within  each 
specified  directory  or  file  name.  If  name  is 
missing,  ^ is  used. 

The  optional  argument  ^s  causes  only  the  grand 
total  to  be  given.  The  optional  argument  ^a 
causes  an  entry  to  be  generated  for  each  file. 
Absence  of  either  causes  an  entry  to  be  generated 
for  each  directory  only. 

A file  which  has  two  links  to  it  is  only  counted 
once. 

/ 


Files  at  the  top  level  (not  under  -a  option)  are 
not  listed. 

Removable  file  systems  do  not  work  correctly 
since  i-n umbers  may  be  repeated  while  the 
corresponding  files  are  distinct.  Du  should 
maintain  an  i-number  list  per  root  directory 
encount  er  ed , 


OWNER 


dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


ed  — editor 
ed  [ name  ] 

ed  is  the  standard  text  editor,  ed  is  based  on 
QED  [reference]  but  is  fully  if  succinctly 
described  here.  Differences  between  ed  and  QED 
are  also  noted  to  simplify  the  transition  to  the 

1 ace  r»r\t.T  oyf  ill  n 4*r\  r 

XWUW  r»  * *.  M V-MA  WW  ^ • 

If  the  optional  argument  is  given,  ed  simulates 
an  e command  on  the  named  file;  that  is  to  say, 
the  file  is  read  into  ed's  buffer  so  that  it  can 
be  edited. 

ed  operates  on  a copy  of  any  file  it  is  editing; 
changes  made  in  the  copy  have  no  effect  on  the 
file  until  an  explicit  write  (w)  command  is 
given.  The  copy  of  the  text  being  edited  resides 
in  a temporary  file  called  the  buffer.  There  is 
only  one  buffer. 

Commands  to  ed  have  a simple  and  regular 
structure:  zero  or  more  addresses  followed  by  a 
single  character  command,  possibly  followed  by 
parameters  to  the  command.  These  addresses 
specify  one  or  more  lines  in  the  buffer.  Every 
command  which  requires  addresses  has  default 
addresses,  so  that  the  addresses  can  often  be 
omitted. 

In  general  only  one  command  may  appear  on  a line. 
Certain  commands  allow  the  input  of  text.  This 
text  is  placed  in  the  appropriate  place  in  the 
buffer.  While  ed  is  accepting  text,  it  is  said 
to  be  in  input  mode.  In  this  mode,  no  commands 
are  recognized;  all  input  is  merely  collected. 
Input  mode  is  left  by  typing  a period  (.)  alone 
at  the  beginning  of  a line. 

ed  supports  a limited  form  of  regular  expression 
notation.  A regular  expression  is  an  expression 
which  specifies  a set  of  strings  of  characters. 

A member  of  this  set  of  strings  is  said  to  be 
matched  by  the  regular  expression.  The  regular 
expressions  allowed  by  ed  are  constructed  as 
follows : 

1.  An  ordinary  character  (not  one  of  those 
discussed  below)  is  a regular  expression 
and  matches  that  character. 

2.  A circumflex  (~)  at  the  beginning  of  a reg- 
ular expression  matches  the  null  character 
at  the  beginning  of  a line. 
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3-. 


4. 


5. 


6. 


7. 


8. 


Regular  expressions  are  used  in  addresses  to 
specify  lines  and  in  one  command  (.s,  see  below) 
to  specify  a portion  of  a line  which  is  to  be 
replaced. 

If  it  is  desired  to  use  one  of  the  regular  ex- 
pression metacharacters  as  an  ordinary  character, 
that  character  may  be  preceded  by  "\" . This  also 
applies  to  the  character  bounding  the  regular 
expression  (often  "/")  and  to  "\  itself. 

Addresses  are  constructed  as  follows.  To  under- 
stand addr.essing  in  it  is  necessary  to  know 
that  at  any  time  there  is  a current  line.  - Gen- 
erally speaking,  the  current  line  is  the  last 
line  affected  by  a command;  however,  the  exact 
effect  on  the  current  line  by  each  command  is 
discussed  under  the  description  of  the  command. 

1.  The  character  addresses  the  current 
line. 

2.  The  character  addresses  the  last  line 

of  the  buffer. 

3.  A decimal  number  n addresses  the  nth  line 
of  the  buffer. 


A currency  symbol  ($)  at  the  end  of  a regu- 
lar expression  matches  the  null  character 
at  the  end  of  a line. 

A period  ( . ) matches  any  character  but  a 
new-line  character. 


A regular  expression  followed  by  an  aster- 

4 olr  { ♦ ^ mz 

wi»  y / niw 


. . . e»  m ^ ^ -v  J 4 — a_ 

uu  jr  ii  umuoi  auja^cilt 


occurrences  (including  zero)  of  the  regular 
expression  it  follows. 

A string  of  'characters  enclosed  in  square 
brackets  ( []  ) ' m'atche  s any  character  in  the 
string  but  no  others.  If,  however,  the 
first  character  of  the  string  is  a circura- 
flex  ( ) the  regular  expression  matches  any 
character  but  new-line  and  the  characters 
in  the  string. 

The  concatenation  of  regular  expressions  is 
a regular  expression  which  matches  the  con- 
catenation of  the  strings  matched  by  the 
components  of  the  regular  expression. 

The  null  regular  expression  standing  alone 
is  equivalent  to  the  last  regular  expres- 
sion encountered. 
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4.  A regular  expression  enclosed  in  slashes 
"/”  addresses  the  first  line  found  by 
searching  toward  the  end  of  the  buffer  and 
stoppxng  at  the  first  line  containing  a 
string  matching  the  regular  expression.  If 
necessary  the  search  wraps  around  to  the 
beginning  of  the  buffer. 

5.  A regular  expression  enclosed  in  queries 
"?"  addresses  the  first  line  found  by 
searching  toward  the  beginning  of  the 
buffer  and  stopping  at  the  first  line  found 
containing  a string  matching  the  regular 
expression.  If  necessary  the  search  wraps 
around  to  the  end  of  the  buffer. 

6.  An  address  followed  by  a plus  sign  "+"  or  a 
minus  sign  followed  by  a decimal  number 
specifies  that  address  plus  (resp.  minus) 
the  indicated  number  of  lines.  The  plus 
sign  may  be  omitted. 

Commands  may  require  zero,  one,  or  two  addresses. 
Commands  which  require  no  addresses  regard  the 
presence  of  an  address  as  an  error.  Commands 
which  require  the  presence  of  one  address  all 
assume  a default  address  (often  ".")  but  if  given 
more  than  one  address  ignore  any  extras  and  use 
the  last  given.  Commands  which  require  two  ad- 
dresses have  defaults  in  the  case  of  zero  or  one 
address  but  use  the  last  two  if  more  than  two  are 
given. 

Addresses  are  separated  from  each  other  typically 
by  a comma  (,).  They  may  also  be  separated  by^a^ 
semicolon  (;).  In  this  case  the  current  line 
is  set  to  the  the  previous  address  before  the 
next  address  is  interpreted.  This  feature  is 
used  to  control  theitstarting  line  for  forward  and 
backward  searches  ("/", 

In  the  following  list  of  ed  commands,  the  default 
addresses  are  shown  in  parentheses.  The 
parentheses  are  not  part  of  the  address,  but  are 
used  to  show  that  the  given  addresses  are  the 
default. 

As  mentioned,  it  is  generally  illegal  for  more 
than  one  command  to  appear  on  a^line.  However ^ 
any  command  may  be  suffixed  by  “p"  (for  "print  ). 
In  that  case,  the  current  line  is  printed  after 
the  command  is  complete. 

In  any  two-address  command,  it  is  illegal  for  the 
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first  address  to  lie  ^fter  the  second  address. 

( . )a 
/text> 

• 

The  append  command  reads  the  given  text  and 
' appends  it  after  the  addressed  line, 
is  left  on  the  last  line  input,  if  there 
were  any,  otherwise  at  the  addressed  line. 
Address  "o"  is  legal  for  this  command;  text 
is  placed  at  the  beginning  of  the  buffer. 
(NOTE:  the  default  address  differs  from 
that  of  QED. ) 

( • » • ) c 

<text> 

* 

The  change  command  deletes  the  addressed 
lines,  then  accepts  input  text  which  re- 
places these  lines.  ",  is  left  at  the 
last  line  input;  if  there  were  none,  it  is 
left  at  the  first  line  not  changed. 

(...)  d 

The  delete  command  deletes^the  addressed 
lines  from  the  buffer.  is  left  at  the 

first  line  not  deleted. 

e filename 

The  edit  command  causes  the  entire  contents 
of  the  buffer  to  be  deleted^  and  then  the 
named  file  to  be  read  in.  ."  is  set  to 
the  last  line  of  the  buffer.  The  number  of 
characters  read  is  typed. 

( 1 ,$)g/regular  express ion/command 

In  the  global  command,  the  first  step  is  to 
mark  every  line  which  matches  the  given 
regular  expression.  Then  for  every  such 
line,  the  given  command  is  executed  with 

set  to  that  line.  The  repeated  command 
cannot  be  a,  £,  it  or  c. 

( . )i 
<text> 

• 

This  command  .inserts  the  given  text  before 
the  addressed  line.  is  left  at  the 

last  line  input;  if  there  were  none,  at  the 
addressed  line.  This  command  differs  from 
the  a command  only  in  the  placement  of  the 
text. 

(.,.)1 

The  list  command  prints  the  addressed  lines 
in  an  unambiguous  way.  Non-printing 


11/3/71 


ED  (I) 


characters  are  over-struck  as  follows: 
char  prints 
bs  \ 

tab  9 

ret  4 

SI  i 

SO  6 

All  characters  preceded  by  a prefix  (ESC) 
character  are  printed  over— struck  with 
without  the  prefix.  Long  lines  are  folded 
with  the  sequence  \newline. 

( • » • )p 

The  jarint  command  prints  the  addressed 
lines.  is  left  at  the  last  line  print- 

ed. 


a 

The  guit  command  causes  ed  to  exit.  No 
automatic  write  of  a file  is  done. 

($)r  filename 

The  jread  command  reads  in  the  given  file 
after  the  addressed  line.  If  no  file  name 
is  given,  the  file  last  mentioned  in  e,  r, 
or  w commands  is  read.  Address  "o"  is 
legal  for  r and  causes  the  file  to  be  read 
at  the  beginning  of  the  buffer.  If  the 
read  is  successful,  the^ntimber  of  charac- 
ters read  is  typed.  is  left  at  the 

last  line  of  the  file. 

( . , . ) s/regular  expression/replacement/ 

The  substitute  command  searches  each  ad- 
dressed line  for  an  occurence  of  the  speci- 
fied regular  expression.  On  each  line  in 
which  a match  is  found,  the  first  (and  only 
first,  compare  QED)  matched  string  is  re- 
placed by  the  replacement  specified.  It  is 
an  error  for  the  substitution  to  fail  on 
all  addressed  lines.  Any  character  other 
than  space  or  new-line  may  be  used  instead 
of  "/  to  delimit  the  regular  expression 
and  the  replacement.  ".  is  left  at  the 
last  line  substituted. 

The  ampersand  appearing  in  the  replace- 
ment is  replaced  by  the  regular  expression 
that  was  matched.  The  special  meaning  of 
& in  this  context  may  be  suppressed  by 
preceding  it  by  ”\". 

( 1 ,$ )w  filename 

The  write  command  writes  the  addressed 
lines  onto  the  given  file.  If  no  file  name 
is  given,  the  file  last  named  in  e,  r,  or  w 
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commands  is  written.  is  unchanged.  If 

the  command  is  successful,  the  number  of 
characters  written  is  typed. 

($)  = 

The  line^number  of  the  addiessed  line  is 
typed.  is  unchanged  by  this  command. 

ft 

1UNIX  command  _ __ 

The  remainder  of  the  line  after  the  " ! " is 
sent  to^UNIX  to  be  interpreted  as  a com- 
mand. is  unchanged. 

<newline>  „ „ 

A blank  line  alone  is  equivalent  to  . + 1p  ; 
it  is  useful  for  stepping  through  text. 

Ed  can  edit  at  most  1500  lines  and  the  maximum 
size  of  a line  is  256  characters.  The  differ- 
ences between  ed  and  QED  are: 

1.  There  is  no  "\f"  character;  input  mode  is 
left  by  typing  ".  alone  on  a line. 

2.  There  is  only  one  buffer  and  hence  no  "\b" 

sstieaxn  directive. 

3.  The  commands  are  limited  to: 

acdegilpqrsw  = ! 

% 

where  e is  new. 

4.  The  only  special  characters  in  regular 
expressions  are: 

which  have>fthe  usual  meanings.  However, 

and  are  only  effective  if  they  are 

the  first  or  last  character  respectively  of 
the  regular  expression.  Otherwise  suppres- 
sion of  special  meaning^is  done  by  preced- 
ing the  character  by  , which  is  not  oth- 
erwise special. 

5.  In  the  substitute  command,  only  the  left- 
most occurrence  of  the  matched  regular 
expression  is  substituted. 

7.  The  a command  has  a different  default  ad- 
dress . 

FILES  /tmp/etma,  etmb,  ...  temporary  h tt 

/etc/msh  is  used  to  implement  the  I command. 
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SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


"?"  for  any  error 

ed  is  used  as  the  shell  for  the  editing  system. 
It  has  the  editing  system  UiD  built  in  and  if 
invoked  under  this  UID  will  give  slightly  dif- 
ferent responses.  This  is  a little  kludgy. 

ken 
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NAME  find  — find  file  with  given  name 

SYNOPSIS  find  name  or  number  ... 

DESCRIPTION  find  searches  the  entire  file  system  hierarchy 

and  gives  the  path  names  of  all  files  with  the 
specified  names  or  (decimal)  i-n umbers. 

FILES  — 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER  dmr 
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NAME 


for  — fortran 


SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


for  file 

for  is  a nearly  complete  fortran  compiler.  file 
is  the  name  of  a fortran  source  program  to  be 
compiled.  The  following  is  a list  of  differences 
between  for  and  ANSI  standard  fortran: 

1.  arbitrary  combination  of  types  are  allowed  in 
expressions.  Not  all  combinations  are  expected 
to  be  supported  in  runtime.  All  of  the  normal 
conversions  involving  integer,  real  and  double 
precision  are  allowed. 

f .tmpl , 2 3 temporary 
/etc/fl,  234  passes 
/etc/xx  runtime 


Diagnostics  are  given  by  number.  If  the  source 
code  is  available,  it  is  printed  with  an  under- 
line at  the  current  character  pointer.  A listing 
of  error  numbers  is  available. 

The  following  is  a list  of  those  features  not  yet 
implemented: 

functions 

arithmetic  statement  functions 
data  statements 
complex  constants 
hollerith  constants 
continuation  cards 

dmr,  ken 
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NAME  form  — form  letter  generator 

• form  proto  arg1  . . . 

form  generates  a form  letter  from  a prototype 
letter | an  associative  memory,  arguments  and  in  a 
special  case,  the  current  date. 

If  form  is  invoked  with  the  argument  x»  the  fol- 
lowing files  come  into  play: 

x.f  prototype  input 
x.r  form  letter  output 
x.ara  associative  memory 

form. am  associative  memory  if  x.am  not  found. 

Basically,  form  is  a copy  process  from  the  file 
x.f  to  the  file  x.r.  If  an  element  of  the  -form 
\n  (where  n is  a digit  from  1 to  9)  is  encoun- 
tered, The  nth  argument  is  inserted  in  its  place, 
and  that  argument  is  then  rescanned.  If  \0  is 
encountered,  the  current  date  is  inserted.  If 
the  desired  argument  has  not  been  given,  a mes- 
sage of  the  form  "\n:  " is  typed.  The  response 
typed  in  then  is  used  for  that  argument. 

If  an  element  of  the  form  [name]  is  encountered, 
the  name  is  looked  up  in  the  associative  memory. 
If  it  is  found,  the  contents  of  the  memory  under 
this  name  replaces  the  original  element  (again 
rescanned.)  If  the  name  is  not  found,  a message 
of  the  form  "name:  " is  typed.  The  response 
typed  in  is  used  for  that  element.  If  the  asso- 
ciative memory  is  writable,  the  response  is  en- 
tered in  the  memory  under  the  name.  Thus  the 
next  search  for  that  name  will  succeed  without 
interaction. 

In  both  of  the  above  cases,  the  response  is  typed 
in  by  entering  arbitrary  text  terminated  by  two 
new  lines.  Only  the  first  of  the  two  new  lines 
is  passed  with  the  text.  The  process  is  instant- 
ly terminated  if  an  end  of  file  is  encountered 
anywhere  except  in  the  associative  memory. 

FILES  x.f  input  file 

x.r  output  file 

x.ara  associative  memory 

form. am  associative  memory 

SEE  ALSO  type 

DIAGNOSTICS  "settup  error"  when  the  appropriate  files  cannot 

be  located  or  created. 


SYNOPSIS 

DESCRIPTION 


BUGS 


settup"  is  misspelled 
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FORM  (I) 


OWNER  rhm, 


ken 
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HUP  (I) 


NAME 

hup  — hang  up  typewriter 

SYNOPSIS 

hu& 

DESCRIPTION 

hup  hangs  up  the  phone  on  the 
uses  it. 

typewriter 

which 

FILES 

— 

SEE  ALSO 

— 

DIAGNOSTICS 

— 

BUGS 

should  not  be  used;  sometimes 
writer  channel  to  be  lost. 

causes  the 

type- 

OWNER 

dmr,  ken 
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LBPPT  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

CWNER 


lbppt  — load  binary  paper  tapes 
lbppt  output  [ input  ] 

lbppt  loads  a paper  tape  in  standard  UNIX  binary 
paper  tape  format.  It  is  used  to  bring  files  to 
a UNIX  installation.  Currently  there  is  a GECOS 
program  to  prepare  a GECOS  file  in  binary  paper 
tape  format. 

If  the  input  file  is  specified,  the  character 
stream  from  that  input  is  expected  to  be  in  UNIX 
binary  paper  tape  format.  If  it  is  not  present, 
/dev/ppt  is  assumed.  The  input  stream  is  inter- 
preted, checksummed,  and  copied  to  the  output 
file. 

/ dev/ ppt 

dbppt,  bppt  format 

"checksum" ; "usage:  ";  "read  error". 


ken 
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LD  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


Id  — link  editor 
Id  [ -usaol  ] name1  ] 

Id  combines  several  object  programs  into  one; 
resolves  external  references;  and  searches  li- 
braries. In  the  simplest  case  the  names  of 
several  object  programs  are  given,  and  Id  com- 
bines them,  producing  an  object  module  which  can 
be  either  executed  or  become  the  input  for  a 
further  Id  run. 

The  argument  routines  are  concatenated  in  the 
order  specified.  The  entry  point  of  the  output 
is  the  beginning  of  the  first  routine. 

If  any  argument  is  a library,  it  is  searched,  and 
only  those  routines  defining  an  unresolved  exter- 
nal reference  are  loaded.  If  any  routine  loaded 
from  a library  refers  to  an  undefined  symbol 
which  does  not  become  defined  by  the  end  of  the 
library,  the  library  is  searched  again.  Thus  the 
order  of  libraries  primarily  affects  the  effi- 
ciency of  loading,  not  what  routines  get  loaded. 

id  understands  several^flag  arguments  which  are 
written  preceded  by  a 

-s  "squash"  the  output,  that  is,  remove  the 
symbol  table  and  relocation  bits  tp  save 
space  (but  impair  the  usefulness  of  the 
debugger).  This  information  can  also  be 
removed  by  strip. 

-u  take  the  following  argument  as  a symbol  and 
enter  it  as  undefined  in  the  symbol  table. 
This  is  useful  for  loading  wholly  from  a 
library,  since  initially  the  symbol  table 
is  empty  and  an  unresolved  reference  is 
needed  to  force  the  loading  of  the  first 
routine. 

-o  set  the  origin  of  the  load  to  the  octal 

number  which  is  given  as  the  next  argument. 
This  option  affects  only  the  definition  of 
relocatable  external  symbols.  See  DMR 
before  using. 

-1  This  option  is  an  abbreviation  for  a li- 
brary name.  „"-l"  alone  stands  for 
"/etc/liba. a" , which  is  the  standard  system 
library  for  assembly  language  programs, 
"-lx"  stands  for  "/etc/libx. a"  where  x is 
any  character.  There  are^libraries  for 
Fortran  (x="f")  and  B ( x="b" ) . 
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LD  (I) 


FILES 

SEE  ALSO 
DIAGNOSTICS 


BUGS 


-a  means  "absolute"  (load  at  origin  absolute 
0)  but  it  doesn't  work. 


The  output  of  Id  is  left  on  a. out.  This  file  is 
executable  only  if  no  errors  occurred  during  the 
load. 

/etc/libx. a.  for  various  xj 
/etc/ltma,  itmb,  ...  (temporary) 
a. out  (output  file) 

as,  strip,  ar  (maintains  libraries) 

"can't  create  temp  file" — unwritable  directory 
or  someone  else  is  using  Id  in  the  same  directo- 
ry. 

"can't  open  temp  file" — maybe  someone  has  delet- 
ed it  out  from  under  you. 

"file  not  found" — bad  argument 

"bad  format" — bad  argument 

"relocation  error  — bad  argument  (relocation 
bits  corrupted) 

"bad  relocation" — user  error:  a.  relocatable 

reference  to  an  external  symbol  that  turns  out  to 
be  absolute. 

"multiply  defined" — same  symbol  defined  twice  in 
same  load 

"un" — stands  for  "undefined  symbol 

"symbol  not  found" — loader  bug 

Option  "-a"  doesn't  work  at  all;  option  "-o 
doesn't  work  right. 


OWNER 


drar 
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LN  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


In  — make  a link 
In  name1  [ name2  ] 

In  creates  a link  to  an  existing  file  name  . If 
name^  is  given,  the  link  has  that  name;  otherwise 
it  is  placed  in  the  current  directory  and  its 
name  is  the  last  component  of  name.,  . 

It  is  forbidden  to  link  to  a directory  or  to  link 
across  file  systems. 


rm , to  uni ink 
"?" 

There  is  nothing  particularly  wrong  with  In,  but 
links  don't  work  right  with  respect  to  the  backup 
system:  one  copy  is  backed  up  for  each  link,  and 

(more  serious)  in  case  of  a file  system  reload 
both  copies  are  restored  and  the  information  that 
a link  was  involved  is  lost. 

ken,  dmr 


OWNER 
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LS  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 

BUGS 


Is  — list  contents  of  directory 
Is  [ -ltasd  ] narae^ 

Is  lists  the  contents  of  one  or  more  directories 
under  control  of  several  options: 

1 list  in  long  format,  giving  i-n umber,  mode, 
owner,  size  in  bytes,  and  time  of  last 
modification  for  each  file.  (see  stat  for 
format  of  the  mode) 

t sort  by  time  modified  (latest  first)  instead 
of  by  name,  as  is  normal 

a list  all  entries;  usually  those  beginning 
with  are  suppressed 

s give  size  in  blocks  for  each  entry 

d if  argument  is  a directory,  list  only  its 
name,  not  its  contents  (mostly  used  with 
"-l"  to  get  status  on  directory) 

If  no  argument  is  given,  "."  is  listed.  If  an 
argument  is  not  a directory,  its  name  is  given. 

/etc/uids  to  get  user  ID's  for  Is  -1 

stat 

"name  nonexistent";  "name  unreadable";  "name 
unstatable. " 

In  :zi*  when  a user  cannot  be  found  in 
/etc/uids,  the  user  number  printed  instead  of  a 
name  is  incorrect.  It  is  correct  in  stat. 


OWNER 


dmr , ken 


1 1/3/71 


MAIL  (I) 


NAME  mail  — send  mail  to  another  user 

SYNOPSIS  mail  [ letter  person  ...  ] 

DESCRIPTION  mail  without  an  argument  searches  for  a file 

called  mailbox,  prints  it  if  present,  ana  asks  if 
it  should  be  saved.  If  the  answer  is  "y",  the 
mail  is  renamed  mail . otherwise  it  is  deleted. 

The  answer  to  the  above  question  may  be  supplied 
in  the  letter  argument. 

When  followed  by  the  names  of  a letter  and  one  or 
more  people,  the  letter  is  appended  to  each 
person's  mailbox.  Each  letter  is  preceded  by  the 
sender's  name  and  a postmark. 

A person  is  either  the  name  of  an  entry  in  the 
directory  /usr.  in  which  case  the  mail  is  sent  to 
/usr /person /mail box,  or  the  path  name  of  a direc- 
tory, in  which  case  mailbox  in  that  directory  is 
used. 

When  a user  logs  in  he  is  informed  of  the  pres- 
ence of  mail. 

FILES  /etc/uids  to  map  the  sender's  numerical  user  ID 

to  name;  mail  and  mailbox  in  various  directories. 

SEE  ALSO  init 

DIAGNOSTICS  "who  are  you?"  if  the  user^cannot  be  identifedw 

for  some  reason  (a  bug).  "cannot  send  to  user" 
if  mailbox  cannot  be  opened. 

BUGS 


OWNER 


ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


mesg  — permit  or  deny  messages 
mesg  [ n ] [ y ] 

mesg  n forbids "messages  via  write  by  revoking 
non-user  write  permission  on  the  user's  typewrit- 
er. mesg  y reinstates  permission,  mesg  with  no 
argument  reverses  the  current  permission.  In  all 

cases  the  Drevious  state  is  retorted. 

* ^ 

/dev/ttyn 

write 

"?"  if  the  standard  input  file  is  not  a typewrit- 
er 


dmr,  ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


mkdir  — make  a directory 
mkdir  dirname 

mkdir  creates  directory  dirname. 

The  standard  entries  and  are  made  au- 

tomatically. 


rmdir  to  remove  directories 


No  permissions  are  checked.  The  system's  user 
ID,  not  that  of  the  creator  of  the  directory, 
becomes  the  owner  of  the  directory. 

ken,  dmr 
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NAME  mkfs  — make  file  system 

SYNOPSIS 

DESCRIPTION 

In  both  cases  the  super-block,  i-list,  and  free 
list  are  initialized^  and  a root  directory  con- 
taining entries  for  . " and  are  created. 

For  RK03's  the  number  of  available  blocks  is 
4872,  for  tapes  578. 

This  program  is  kept  in  /etc  to  avoid  inadvertant 
use  and  consequent  destruction  of  information. 

FILES  /dev/ tapO , / dev/ rkO 

SEE  ALSO 

DIAGNOSTICS  **Arg  count”,  "Unknown  argument",  "open  error". 

BUGS 

ken , dmr 


/etc/mkf s t 
/ etc  /m  k f s r 

mkfs  initializes  either  a DECtape^ ( argument  t ) 
or  an  RK03  disk  pack  ( argument  r")  so  that  it 
contains  an  empty  file  system,  mkfs  or  its 

o,v-.+-  mnpf  Vs  o-Fz-'i  >-  d a -h  anfi  r*  P.V  pa, 

ws  uj.  V ux  i \m  ill  uo  u yj  v—  v«  w v vx  x/  wx.  wx  w w w wx  £•»  w 

be  mounted  as  a file  system. 


OWNER 
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NAME  mount  — mount  file  system 

SYNOPSIS  mount  special  dir 

DESCRIPTION  mount  announces  to  the  system  that  a removable 

file  system  has  been  mounted  on  the  device 
corresponding  to  special  file  special.  Directory 
dir  (which  must  exist  already)  becomes  the  name 
of  the  root  of  the  newly  mounted  file  system. 

FILES 

SEE  ALSO  umount 

DIAGNOSTICS  "?”,  if  the  special  file  is  already  in  use,  can- 

not be  read,  or  if  dir  does  not  exist. 

BUGS  Should  be  usable  only  by  the  super- user. 

OWNER  ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


BUGS 


OWNER 


mv  — move  or  rename  a file 
mv  narae^  nan^ 

mv  changes  the  name  of  name,  by  linking  to  it 
under  the  name  name,  and  then  unlinking  name. . 
Several  pairs  of  arguments  may  be  given.  If 1 the 
new  name  is  a directory,  the  file  is  moved  to 
that  directory  under  its  old  name.  Directories 
may  only  be  moved  within  the  same  parent  directo- 
ry (just  renamed). 


”?a” — incorrect  argument  count 
^?d" — : attempt  to  move  a directory 
"?s" — moving  file  to  itself 

"?l" — link  error;  old  file  doesn't  exist  or 
can't  write  new  directory 
"?u" — can't  unlink  old  name 

If  mv  succeeds  in  removing  the  target  file,  but 
then  in  unable  to  link  back  to  the  old  file,  the 
result  is  ?1  and  the  removal  of  the  target  file. 
This  is  common  with  demountable  file  systems  and 
should  be  circumvented.  Also  in  such  cases,  mv 
should  copy  if  it  can. 

ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


nm  — get  name  list 
nm  [ name  ] 

nm  prints  the  symbol  table  from  the  output  file 
of  an  assembler  or  loader  run.  Only  relocatable, 
global,  and  undefined  symbols — not  absolute — 
are  given.  Each  defined  symbol  is  preceded  by 
its  value;  each  undefined  symbol  by  blanks.  Glo- 
bal symbols  have  their  first  character  under- 
lined. The  output  is  sorted  alphabetically. 

If  no  file  is  given,  the  symbols  in  a. out  are 
listed. 

a. out 

as,  Id 


dmr,  ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 


od  — octal  dump 
od  name  [ origin  ] 

od  dumps  a file  in  octal,  eight  words  per  line 
with  the  origin  of  the  line  on  the  left.  If  an 
octal  origin  is  given  it  is  truncated  to  0 mod  16 
and  dumping  starts  from  there,  otherwise  from  0, 
Printing  continues  until  halted  by  sending  an 
interrupt  signal. 


db 


if 


BUGS 


OWNER 


Dumping  does  not  cease  at  the  end  of  the  file; 
instead  the  file  appears  to  be  padded  with  gar- 
bage to  a length  of  511  mod  512  bytes, 

ken , dmr 
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NAME  pr  — print  file 

SYNOPSIS  pr  [ -lcm  ] name1  ... 

DESCRIPTION  pr  produces  a printed  listing  of  one  or  more 

files.  The  output  is  separated  into  pages  headed 
by  the  name  of  the  file,  a date,  and  the  page 
number . 

The  optional  flag  ^ causes  each  page  to  contain 
78  lines  instead  of  the  standard  66  to  accommo- 
date legal  size  paper. 

The  optional  flags  (current  date)  and 

(modified  date)  specify  which  date  will  head  all 
subsequent  files,  is  default. 

FILES  /dev/ttyn  to  suspend  messages. 

SEE  ALSO  cat,  cp,  mesg 

DIAGNOSTICS  — (files  not  found  are  ignored) 

BUGS  none 

OWNER  ken,  dmr 
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REW  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


rew  — rewind  tape 
rew  [ digit  ] 

rew  rewinds  DECtape  drives.  The  digit  is  the 
logical  tape  number,  and  should  range  from  0 to 
7.  A missing  digit  indicates  drive  0. 

/dev/tapO,  ...»  /dev/tap7 


"?”  if  there  is  no  tape  mounted  on  the  indicated 
drive  or  if  the  file  cannot  be  opened. 


ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


rkd  — dump  RK  disk  to  tape 
/etc /rkd 

rkd  copies  an  RK03/RK05  disk  pack  onto  nine 
DECtapes. 

Physical  I/O  is  done  and  interrupts  are  disabled, 
so  time— sharing  is  suspended  during  operation  of 
the  command. 

The  sequence  of  tape  drives  is:  0,  1,  0,  1,  .... 
rkd  exits  if  0 appears  in  the  console  switches. 

rkl 

none;  errors  are  retried  forever 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


OWNER 


rkf  — format  RK03  disk  pack 


rkf 


rkf  formats  a virgin  disk  pack.  Because  it  des- 
troys all  information  on  that  pack,  and  because 
it  is  not  interlocked  against  file  system  activi- 
ty on  the  pack,  the  rkf  program  is  not  maintained 


X.KJ  JL  111  * 


owuj.\,c  must  v rz 


located  and  assembled. 


none  (uses  physical  I/O  on  drive  0). 


"error"  is  printed  and  a core  image  is  produced 
if  a write  error  occurs.  A copy  of  the  RK  status 
register  is  in  register  5. 

As  mentioned,  rkf  is  not  interlocked  against  sys- 
tem I/O;  if  I/O  is  already  occurring,  it  will  be 
badly  disrupted.  In  any  event,  all  information 
on  the  pack  is  destroyed. 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


rkl  — reload  RK  diskc  from  tape 
/ etc/rkl 

rkl  loads  an  RK05/RK05  disk  pack  from  nine 
DECtapes. 

The  program  uses  physical  I/O  with  interrupts 
disabled}  therefore  time— sharing  is  suspended* 

Only  the  super-user  may  invoke  this  command. 

The  sequence  of  drives  is:  0,  1,  0,  1,  ....  rkl 
will  cease  if  0 appears  in  the  console  switches. 


rkd 

none;  errors  are  retried  forever 


ken 
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NAME  rm  — remove  (unlink)  files 

SYNOPSIS  rm  name1  ... 

DESCRIPTION  rm  removes  the  entries  for  one  or  more  files  from 

a directory.  If  an  entry  was  the  last  link  to 
the  file,  the  file  is  destroyed.  Removal  of  a 
file  requires  write  permission  in  its  directory, 
but  neither  read  nor  write  permission  on  the  file 
itself. 

Directories  cannot  be  removed  by  rm;  cf.  rmdir. 

FILES  none 

SEE  ALSO  rmdir,  for  removing  directories. 

DIAGNOSTICS  If  the  file  cannot  be  removed  or  does  not  exist, 

the  name  of  the  file  followed  by  a question  mark 
is  typed. 

BUGS  rm  probably  should  ask  whether  a read-only  file 

is  really  to  be  removed. 

OWNER  ken,  dmr 
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NAME  rmdir  — remove  directory 

SYNOPSIS  rmdir  dir1  . . . 

DESCRIPTION  rmdir  removes  (deletes)  directories.  The  direc- 
tory must  be  emptjr  (except  for  the  standard  en- 
tries and  "..  , which  rmdir  itself  removes). 
Write  permission  is  required  in  the  directory  in 

tjVvi  riVi  t-  Vie*  <-H  nrv  ann^ars. 

— — - — — ~-j  -rr 

FILES  none 

SEE  ALSO 

DIAGNOSTICS  "dir?"  is  printed  if  directory  dir  cannot  be 

found,  is  not  a directory,  or  is  not  removable. 

"dir  — directory  not  empty"  is  printed  if  dir 
has  entries  other  than  ",  or  ... 

BUGS 

OWNER  ken,  dmr 
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NAME 


roff  — format  text 


SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


roff  [ +number  ] [ -number  ] name1  ... 

roff  formats  text  according  to  control  lines 
embedded^in  the  text.  The  optional  argument 
"♦number"  causes  printing  to  begin^at  the  first 
page  with  the  appropriate  number;  "-number" 
causes  printing  to  cease  at  the  first  page  with  a 
higher  number. 

roff  is  fully  described  in  a separate  publication 
[reference]  . 

/etc/ suftab  contains  a list  of  suffixes  used  to 
guide  hyphenation,  /tmp/rtma,  rtmb,  ...  tem- 
porary. /dev/ttyn  to  suspend  messages. 

[reference]  , mesg 

none  — files  not  found  are  ignored 

roff  does  not  check  for  various  kinds  of  buffer 
overflow.  if  a fault  occurs,  check  the  input  in 
the  region  where  the  error  occurred. 

jfo,  dmr,  ken 


OWNER 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


sdate  — set  date  and  time 
sdate  mmddhhmm 

sdate  adjusts  the  system's  idea  of  the  date  and 
time,  mm  is  the  month  number;  dd  is  the  day 
number  in  the  month;  hh  is  the  hour  number 
(24-hour  system);  mm  is  the  minute  number.  For 
example, 


sdate  10080045 


sets  the  date  to  Oct.  8,  12:45  AM. 
none 


date 

"? " if  the  date  is  syntactically  incorrect, 
none 


OWNER 


ken,  dmr 


11/3/71 


SH  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


sh  — shell  (command  interpreter) 

sh  [ name  [ arg1  ...  [ argg  ] ] ] 

sh  is  the  standard  command  interpreter.  It  is 
the  program  which  reads  and  arranges  the  execu- 
tion of  the  command  lines  typed  by  most  users. 

It  may  itself  be  called  as  a command  to  interpret 
files  of  command  lines.  Before  discussing  the 
arguments  to  the  shell  used  as  a command,  the 
structure  of  command  lines  themselves  will  be 
given. 

Command  lines  are  sequences  of  commands  separated 
by  command  delimiters.  Each  command  is  a se- 
quence of  non-blank  command  arguments  separated 
by  blanks.  The  first  argument  specifies  the  name 
of  a command  to  be  executed.  Except  for  certain 
types  of  special  arguments  discussed  below,  the 
arguments  other  than  the  command  name  are  simply 
passed  to  the  invoked  command. 

If  the  first  argument  represents  the  path  name  of 
an  executableMfile,  it  is  invoked;  otherwise  the 
string  "/bin/"  is  prepended  to  the  argument.  (In 
this  way  the  standard  commands,  which  reside  in 
"/bin",  are  found.)  If  this  search  too  fails  a 
diagnostic  is  printed. 

The  remaining  non-special  arguments  are  simply 
passed  to  the  command  without  further  interpreta- 
tion by  the  shell. 

There  are  three^command  delimiters: w the  new 
line,  and  "&".  The  semicolon  specifies 

sequential  execution  of  the  commands  so 
separated;  that  is, 

coma ; comb 

causes  the  execution  firstnof  command  coma . then 
of  comb.  The  ampersand  causes  simultaneous 

execution: 

coma  & comb 

causes  coma  to  be  called,  followed  immediately  by 
comb  without  waiting  for  coma  to  finish.  Thus 
coma  and  comb  execute  simultaneously.  As  a spe- 
cial case, 

coma  & 

causes  coma  to  be  executed  and  the  shell  immedi- 
ately to  request  another  command  without  waiting 
for  coma. 
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Two  characters  cause  the  immediately  following 
string  to  be  interpreted  as  a special  argument  to 
the  shell  itself,  notjpassed  to  the  command.  An 
argument  of  the  form  "<arg"  causes  the  file  arg 
to  be  used  as  the  standard  input  file  of  thet< 
given  command;  an  argument  of  the  form  ")>arg" 
causes  file  "arg"  to  be  used  as  the  standard  out- 
put file  for  the  given  command. 

If  any  argument  contains  either  of  the  characters 
"?"  or  "*  , it  is  treated  specially  as  follbws. 
The  current  directory  is  searched  for  files^which 
match  the  given  argument.  The  character  "*"  in 
an  argument  matches  any  string  of  characters  in  a 
file  name  (including  the  null  string);  ?" 
matches  any  single  character  in  a file  name. 

Other  argument  characters  match  only  the  same 
character  in  the  file  name^  For  example,  "*" 
matches  all  file  names;  "? " matches  all  one— char- 
acter file  names;  |]ab*.s"  matches  all  file  names 
beginning  with  "ab"  and  ending  with  .s  . 

If^the  argument  with  or  "? " also  contains  a 

”/",  a slightly  different  procedure  is  used: 
instead  of  the  current  directory,  the  directory 
used  is  the  onejobtained  by  taking  the  argument 
up  to  the  last  "/"  before  a "*"  or  "?".  The 
matching  process  matches  the  remainder  of  the 
argument  after  this  "/"  against  the  files  in  the 
derived  directory.  For  example:  "/usr/dmr/a*. s 
matches  all^files  in  directory  "/usr/dmr  which 
begin  with  "a"  and  end  with  ".s  . 

In  any  event,  a list  of  names  is  obtained  which 
match  the  argument.  This  list  is  sorted  into 
alphabetical  order,  and  the  resulting  sequence  of 
arguments  replaces  the  single  argument  containing 
the  "*"  or  "?".  The  sametiprocess  is  carried  out 
for  each  argument  with  a or  "?"  (the  result- 
ing lists  are  not  merged)  and  finally  the  command 
is  called  with  the  resulting  list  of  arguments.. 

For  example:  directory  /usr/dmr  contains  the 
files  al.s,  a2.s,  ...,  a9.s.  From  any  directory, 
the  command 

as  /usr/dmr/a? . s 

calls  a.s  with  arguments  /usr/dmr/al  . s , 
/usr/dmr/a2.s , ...  /usr/dmr/a9. s in  that  order. 

The  character  "\”  causes  the  immediately  follow- 
ing character  to  lose  any  special  meaning  it  may 
have  to  the  shell;  in  this  way  "<",  > , and 

other  characters  meaningful  to  the  shell  may  be 
passed  as  part  of  arguments.  A special  case  of 
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FILES 
SEE  ALSO 

DIAGNOSTICS 


this  feature  allows  the  continuation  of  commands 
onto  more  than  one  line:  a new-line  preceded  by 

"\"  is  translated  into  a blank. 

Sequences  of  characters  enclosed  in  double  (")  or 
single  (')  quotes  are  also  taken  literally. 

When  the  shell  is  invoked  as  a command,  it  has 
additional  string  processing  Capabilities*  Re— 
call  that  the  form  in  which  the  whell  is  invoked 
is 


sh  [ name  [ arg^j  ...  [ argg  ] ] ] 

The  name  is  the  name  of  a file  which  will  be  read 
and  interpreted.  If  not  given,  this  subinstance 
of  the  shell  will  continue  to  read  the  standard 
input  file. 

In  the  file,  character  sequences  of  the  form 
"$n",  where  n is  a digit  0,  ...»  9,  are  replaced 
by  the  nth  argument  to  the  invocation  of  the 
shell  (arg^).  "$0"  is  replaced  by  name. 

An  end-of-file  in  the  shell's  input  causes  it  to 
exit.  A side  effect  of  this  fact  means  that  the 
way  to  log  out  from  UNIX  is  to  type  an  end  of 
file. 

/etc /glob 

[reference] , which  gives  the  theory  of  operation 
of  the  shell, 

"?",  in  case  of  any  difficulty.  The  most  common 
problem  is  inability  to n find  the  given  command. 
Others:  input  file  ("<")  cannot  be  found;  no 

more  processes  can  be  created  (this  will  allevi- 
ate itself  with  the  passage  of  time).  Note  that 
no  diagnostic  is  given  for  inability  to  create  an 
output  (">")  file;  the  standard  output  file  has 
already  been  closed  when  the  condition  is 
discovered  and  there  is  no  place  to  write  the 
diagnostic. 

If  a or  "?"  is^used,  the  glob  routine  is 
invoked;  it  types  * No  command  if  it  cannot  find 
the  given  command,  and  "No  match"  if  there^were 
no  files  which  matched  an  argument  with  "?"  or 

• 

Better  diagnostics  should  be  provided.  If  a 
or  "?"  is  used,  the  command  must  be  in  /bin . 

(Ndt,  for  example,  in  the  user's  directory.)  This 
is  actually  a glob  bug. 


BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 

DIAGNOSTICS 


stat  — get  file  status 
stat  narae1  . . . 

stat  gives  several  kinds  of  information  about  one 
or  more  files: 

i -number 

number  of  links 
owner 

size  in  bytes 

date  and  time  of  last  modification 

name  (useful  when  several  files  are  named) 

All  information  is  self-explanatory  except  the 
mode.  The  mode  is  a six-character  string  whose 
characters  mean  the  following: 

1 s:  file  is  small  (smaller  than  4096  bytes) 

1:  file  is  large 

2 d:  file  is  a directory 
x:  file  is  executable 

u:  set  user  ID  on  execution 
-:  none  of  the  above 

3 r:  owner  can  read 

-:  owner  cannot  read 

4 w:  owner  can  write 

-:  owner  cannot  write 

5 r:  non-owner  can  read 

-:  non-owner  cannot  read 

6 w:  non-owner  can  write 

-:  non-owner  cannot  write 

The  owner  is  almost  always  given  in  symbolic 
form;  however  if  he  cannot  be  found  in 
"/etc/uids"  a number  is  given. 

If  the  number  of  arguments  to  stat  is  not  exactly 
1 a header  is  generated  identifying  the  fields  of 
the  status  information. 

/etc/uids 

Is  with  the  "-l"  option  gives  the  same  informa- 
tion as  stat. 

"name?"  for  any  error. 


BUGS 


none 
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NAME  strip  — remove  symbols  and  relocation  bits 

SYNOPSIS  strip  name,  . . . 

I 

DESCRIPTION  strip  r 6no v 0 s the  symbol  tehle  and  relocation 

bits  ordinarily  attached  to  'the  output  of  the 
assembler  and  loader.  This  is  useful  to  save 
space  after  a program  has  been  debugged. 

The  effect  of  strip  is  the  same  as  use  of  the  ^s 
option  of  Id. 

FILES  /tmp/stma,  stmb  ...-  temporary  file 

SEE  ALSO  Id,  as 

DIAGNOSTICS  Diagnostics  are  given  for:  non-existent  argument; 

inability  to  create  temporary  file; 
improper  format  (not  an  object  file); 
inability  to  re-read  temporary  file, 

BUGS 

OWNER  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


su  — become  privileged  user 


su  password 


su  allows  one  to. become  the  super-user,  who  has 
all  sorts  of  marvelous  powers.  In  order  for  su 
to  do  its  magic,  the  user  must  pass  as  an  argu- 
ment a password.  If  the  password  is  correct,  su 


• 1 1 - - 4-  — 4-  T_  — 

win  execute  cue  ouci 


IT  *U  4.1^, 

-L  Wltil  LHC 


- />  ^ \\ 


of  the  super-user.  To  restore  normal  UID 
privileges,  type  an  end-of-file  to  the  super-user 
shell . 


shell 

"Sorry"  if  password  is  wrong 


dmr,  ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

PTT 

j.-  1UUU 

SEE  ALSO 
DIAGNOSTICS 

BUGS 

OWNER 


sum  — sum  file 
sum  name 

sum  sums  the  contents  of  a file.  In  practice,  it 
is  most  often  used  to  verify  that  all  of  a 
DECtape  can  be  read  without  error. 


"?"  if  the  file  cannot  be  read  at  all  or  if  an 
error  is  discovered  during  the  read. 

none 

ken 


11/3/71 


TAP  (I) 


NAME 

SYNOPSIS 


tap  — manipulate  DECtape 
tap  [ key  ] [ name  ...  ] 


DESCRIPTION 


tap  saves  and  restores  selected  portions  of  the 
file  system  hierarchy  on  DECtape.  Its  actions 
are  controlled  by  the  key  argument.  The  key  is  a 
string  of  characters  containing  at  most  one  func- 
ticn  Icttsr  snd  possibly  on  s o t luor c function 
modifiers.  Other  arguments  to  the  command  are 
file  or  directory  names  specifying  which  files 
are  to  be  dumped,  restored,  or  tabled. 


The  function  portion  of  the  key  is  specified  by 
one  of  the  following  letters: 

r The  indicated  files  and  directories,  to- 
gether with  all  subdirectories,  are  dumped 
onto  the  tape.  If  files  with  the  same 
names  already^exist , they  are  replaced 
(hence  the  "r").  "Same"  is  determined  by 
string  comparison,  so  ’ ./abc*  can  never  be 
the  same  as  "/usr/dmr/abc"  even  if 
"/usr/dmr”  is  the  current  directory.  If  no 
file  argument  is  given,  "/"  is  the  default. 

u updates  the  tape,  u is  the  same  as  r,  but 
a file  is  replaced  only  if  its  modification 
date  is  later  than  the  date  stored  on  the 
tape;  that  is  to  say,  if  it  has  changed 
since  it  was  dumped,  u is  the  default  com- 
mand if  none  is  given. 

d deletes  the  named  files  and  directories 
from  the  tape.  At  least  one  file  argument 
must  be  given. 

x extracts  the  named  files  from  the  tape  to 
the  file  system.  The  owner,  mode,  and 
date-modified  are  restored  to  what  they 
were  when  the  file  was  dumped.  If  no  file 
argument  is  given,  the  entire  contents  of 
the  tape  are  extracted. 

t lists  the  names  of  all  files  stored  on  the 
tape  which  are  the  same  as  or  are  hierarch- 
ically below  the  file  arguments.  If  no 
file  argument  is  given,  the  entire  contents 
of  the  tape  are  tabled. 

1 is  the  same  as  t except  that  an  expanded 
listing  is  produced  giving  all  the  avail- 
able information  about  the  listed  files. 

The  following  characters  may  be  used  in  addition 
to  the  letter  which  selects  the  function  desired. 
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0,  ...»  7 This  modifier  selects  the  drive  on 
which  the  tape  is  mounted.  ' 0 is  the 
def  ault . 

v Normally  tap  does  its  work  silently.  The  v 
(verbose)  option  causes  it  to  type  the  name 
of  each  file  it  treats  preceded  by  a letter 
to “indicate  what  is  happening. 

r file  is  being  replaced 
a file  is  being  added  (not  there  before) 
x file  is  being  extracted 
d file  is  being  deleted 

The  y option  can  be  used  with  r,  u,  d,  and 
x only. 

c means  a fresh  dump  is  being  created;  the 
tape  directory  will  be  zeroed  before  begin- 
ning. Usable  only  with  r and  u. 

f causes  new  entries  copied  on  tape  to  be 
'fake'  in  that  only  the  entries,  not  the 
data  associated  with  the  entries  are  updat- 
ed, Such  fake  entries  cannot  be  extracted. 
Usable  only  with  r and  u. 

w causes  tap  to  pause  before  treating  each 
file,  type  the  indicative  letter  and ^ the 
file  name  (as  with  vj[  await  the  user's 
resppnse.  Response  y"  means  yes  , so  the 
file'  is  treated.  Null  response  means  "no*  , 
and  the  file  does  not  take  gart  in  whatever 
is  being  done.  Response  “x  means  exit  ; 
the  tap  command  terminates  immediately.  In 
the  x function,  files  previously  asked 
about  have  been  extracted  already.  With  r, 
u,  and  d no  change  has  been  made  to  the 
tape. 

m make  (create)  directories  during  an  x if 
necessary. 

i ignore  tape  errors.  It  is  suggested  that 
this  option  be  used  with  caution  to  read 
damaged  tapes. 

/dev/tapO  ...  /dev/tap7 


RK  open  error 
RK  read  error 
RK  write  error 
Directory  checksum 
Directory  overflow 


DIAGNOSTICS 
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RK  overflow 

Phase  error  (a  file  has  changed  after  it  was 
selected  for  dumping  but  before  it  was  dumped) 

All  references  to  "rk"  should  read  "tape."  The  m 
option  does  not  work  correctly  in  all  cases.  The 
i_  option  is  not  yet  implemented. 


BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 
DIAGNOSTICS 

BUGS 


tm  — provide  time  information 
tm  [ command  arg^  ....  ] 

tm  is  used  to  provide  timing  information.  When 
used  without  an  argument,  output  like  the  follow- 
ing is  given: 


tim 

77:43: 20 

79.  2 

ovh 

13:59:42 

r.2 

dsk 

12:06:30 

4.1 

idl 

352:31 :37 

23.7 

usr 

3:32:15 

0.1 

der 

5,  171 

0,  0 

The  first  column  of  numbers  gives  totals  in  the 
named  categories  since  the  last  time  the  system 
was  cold-booted;  the  second  column  gives  the 
changes  since  the  last  time  tm  was  invoked.  The 
tim  row  is  total  real  time  (hours: minutes: 
seconds);  unlike  the  other  times,  its  origin  is 
the  creation  date  of  tm's  temporary  file,  ovh  is 
time  spent  executing  in  the  system;  dsk  is  time 
spent  waiting  for  both  kinds  of  disk  I/O;  idl  is 
idle  time;  usr  is  user  execution  time;  der  is  RF 
disk  error  count  (left  number)  and  RK  disk  error 
count  (right  number). 

tm  can  be  invoked  with  arguments  which  are  as- 
sumed to  constitute  a command  to  be  timed.  In 
this  case  the  output  is  as  follows: 


tim 

2.2 

ovh 

0.3 

dsk 

1.8 

idl 

0.0 

usr 

0.0 

The  given  times  represent  the  number  of  seconds 
spent  in  each  category  during  execution  of  the 
command. 

/tmp/ttmp,  /dev/rfO  (for  absolute  times)  contains 
the  information  used  to  calculate  the  differen- 
tial times. 

format  of  file  system  (which  tells  where  the 
times  come  from) 

"?"  if  the  command  cannot  be  executed;  [[can't 
creat  temp  file”  if  trouble  with  ttmp;  "cant  read 
super-block"  if  times  cannot  be  read  from  system. 

(1)  when  invoked  with  a command  argument,  every- 
thing going  on  at  the  moment  is  counted,  not  just 
the  command  itself.  (2)  Two  users  doing  tm 
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simultaneously  interfere  with  each  other's  use  of 
the  temporary  file. 

f dmr 
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NAME 

tty  — get  tty  name 

synopsis 

tty 

DESCRIPTION 

ttv  givest<the  name  of  the  user's  typewriter  in 
the  form  "ttyn"  for  n an digit.  The  actual  path 
name  is  then  "/dev/ ttyn  . 

FILES 

— 

SEE  ALSO 

— 

DIAGNOSTICS 

"not  a tty"  if  the  standard  input  file  is  not  a 
typewriter. 

BUGS 

— 

OWNER 

dmr,  ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


type  — type  on  2741 
type  naine^  . . . 

type  produces  output  on  an  IBM  2741  terminal  with 
a Correspondence  type  ball. 

type  uses  typewriter  tty5,  which,  because  of  the 
lack  of  access  ports,  is  also  used  as  a standard 
communication  channel.  Therefore,  who  should  be 
used  to  verify  the  absence  of  a user  on  tty5. 

The  method  is  as  follows:  type  the  type  command. 
It  will  wait  until  tty5  is  dialled  up.  When  the 
phone  answers,  depress  the  interrupt  button  after 
paper  has  been  loaded,  and  the  first  file  will  be 
typed.  type  spaces  out  to  the  end  of  a sheet  of 
paper  and  waits  until  the  interrupt  button  is 
depressed  before  beginning  each  new  file. 

/dev/tty5 

who 


Obviously  some  scheme  is  needed  to  prevent  in- 
terference between  normal  users  and  type.  The 
best  thing  would  be  to  support  2741 's  as  a stan- 
dard terminal. 

dmr 
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umount  — dismount  file  system 
umount  special 

umount  announces  to  the  system  that  the  removable 
file  system  previously  mounted  on  special  file 
special  is  to  be  removed. 

Onlv  the  super-user  mav  issue  this  command. 

■ * -*■ 


mount 

? 

This  command  should  be  restricted  to  the  super- 
user. 

ken , dmr 
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NAME  un  — undefined  symbols 

SYNOPSIS  un  [ name  ] 

DESCRIPTION  un  prints  a list  of  undefined  symbols  from  an 

assembly  or  loader  run.  if  the  file  argument  is 
not  specified,  a. out  is  the  default.  Names  are 
listed  alphabetically  except  that  non-global  sym- 
bols come  first.  Undefined  global  symbols  (un- 
resolved external  references)  have  their  first 
character  underlined. 

FILES  a. out 

SEE  ALSO  as,  Id 

DIAGNOSTICS  "?"  if  the  file  cannot  be  found. 

BUGS 

OWNER  dmr , ken 
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NAME  wc  — get  (English)  word  count 

SYNOPSIS  wc  narae1  . . . 

DESCRIPTION  wc  provides  a count  of  the  words,  text  lines,  and 

roff  control  lines  for  each  argument  file. 

A text  line  is  a sequence  of  characters  not  be- 

•t  ii  — 

rrinninrr  u-l  f anH  onH  Ywr  a nPu-Hno  A r*  off 

*3  -•-****  — **-3  — w**  • — n ■ m 

control  line  is  a line  beginning  with  . . A 
word  is  a sequence  of  characters  bounded  by  the 
beginning  of  a line,  by  the  end  of  a line,  or  by 
a blank  or  a tab. 

FILES 

SEE  ALSO  roff 

DIAGNOSTICS  none;  arguments  not  found  are  ignored. 

BUGS 

OWNER  jfo 
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NAME 

who  — who  is  on  the  system 

SYNOPSIS 

who 

DESCRIPTION 

who  lists  the  name,  typewriter  channel,  and  login 
time  for  each  current  UNIX  user. 

FILES 

/tmp/utmp  contains  the  necessary  information; 
is  maintained  bv  init. 

it 

SEE  ALSO 

/etc/init 

DIAGNOSTICS 

— 

BUGS 

— 

OWNER 

dmr,  ken 

11/3/71 


WRITE  (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


write  — write  to  another  user 
write  user 

write  copies  line-s  from  your  typewriter  to  that 
of  another  user*  When  first  called,  write  sends 
the  message 

message  from  yourname... 

The  recipient  of  the  message  should  write  back  at 
this  point.  Communication  continues  until  an  end 
of  file  is  read  from  the  typewriter  or  an  inter- 
rupt is  sent.  At  that  point  write  writes  "eot" 
on  the  other  terminal. 

Permission  to  write  may  be  denied  or  granted  by 
use  of  the  mescr  command.  At  the  outset  writing 
is  allowed.  Certain  commands,  in  particular  roff 
and  £r,  disallow  messages  in  order  to  prevent 
messy  output. 

If  the  character  "l"  is  found  at  the  beginning  of 
a line,  write  calls  the  mini-shell  msh  to  execute 
the  rest  of  the  line  as  a command. 

The  following  protocol  is  suggested  for  using 
write:  When  you  first  write  to  another  user,  wait 
for  him  to  write  back  before  starting  to  send. 
Each  party  should^end^each  message  with  a dis- 
tinctive signal  ("(o)"  for  "over  isf convention- 
al) that  the  other  may  reply.  "(oo)”  (for  "over 
and  out")  is  suggested  when  conversation  is  about 
to  be  terminated. 

/tmp/utmp  is  used  to  discover  the  target  user's 
typewriter  channel  and  the  sending  user's  name. 
msh  is  used  to  execute  commands. 

me  sg 

"user  not  logged  in";  "permission  denied". 


OWNER 


drar,  ken 
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SYS  BREAK  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


break  — set  program  break 

sys  break;  addr-  / break  =17. 

break  sets  the  system's  idea  of  the  highest  loca- 
tion used  by  the  program  to  addr.  Locations 
greater  than  addr  and  below  the  stack  pointer  are 
not  swapped  and  are  thus  liable  to  unexpected 
mod. if  i cst  ion  * 

If  the  argument  is  0 or  higher  than  the  stack 
pointer  the  entire  4K  word  user  core  area  is 
swapped. 

When  a program  begins  execution  via  exec  the 
break  is  set,  at  the  highest  location  defined  by 
the  program  and  data  storage  areas.  Ordinarily, 
therefore,  only  programs  with  growing  data  areas 
need  to  use  break. 


exec 

none;  strange  addresses  cause  the  break  to  be  set 
to  include  all  of  core. 


BUGS 

OWNER  ken,  dmr 
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SYS  CEMT  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


cemt  — catch  emt  traps 

sys  cemt;  arg  / cemt  = 29.;  not  in  assembler 

This  call  allows  one  to  catch  traps  resulting 
from  the  emt  instruction.  Arg  is  a location 
within  the  program;  emt  traps  are  sent  to  that 
location.  The  normal  effect  of  emt  traps  may  be 
restored  by  giving  an  arc?  equal  to  0* 

Prior  to  the  use  of  this  call,  the  result  of  an 
emt  instruction  is  a simulated  rts  instruction. 
The  operand  field  is  interpreted  as  a register, 
and  an  rts  instruction  is  simulated  for  that 
register  (after  verifying  that  various  registers 
have  appropriate  values).  This  feature  is  useful 
for  debugging,  since  the  most  dangerous  program 
bugs  usually  involve  an  rts  with  bad  data  on  the 
stack  or  in  a register. 


OWNER 


ken,  dmr 
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SYS  CHDIR  (IP) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


chdir  — change  working  directory 

sys  chdir;  dirname  / chdir  = 12. 

dirname  is  address  of  the  pathname  of  a directo- 
ry, terminated  by  a 0 byte.  chdir  causes  this 
directory  to  become  the  current  working  directo- 
ry. 


The  error  bit  (c-bit)  is  set  if  the  given  name  is 
not  that  of  a'  directory. 


OWNER 


ken,  dmr 
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SYS  CHMOD  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


chmod  — change  mode  of  file 

sys  chmod;  name;  mode  / chmod  = 15. 

The  file  whose  name  is  given  as  the  null- 
terminated  string  pointed  to  by  name  has  its  mode 
changed  to  mode.  Modes  are  constructed  by  orinq 
together  some  combination  of  the  following: 

01  write,  non-owner 

02  read,  non-owner 
04  write,  owner 

1 0 read , owner 
20  executable 

40  set  user  ID  on  execution 

Only  the  owner  of  a file  (or  the  super-user)  may 
change  the  mode. 


Error  bit  (c-bit)  set  if  name  cannot  be  found  or 
if  current  user  is  neither  the  owner  of  the  file 
nor  the  super-user. 


OWNER 


ken,  dmr 
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SYS  CHOWN  (II) 


NAME  chown  — change  owner  of  file 

SYNOPSIS  sys  chown;  name;  owner  / chown  =16. 

DESCRIPTION  The  file  whose  name  is  given  by  the  null- 

terminated  string  pointed  to  by  name  has  its  own- 
er changed  to  owner.  Only  the  present  owner  of  a 
file  (or  the  super-user)  may  donate  the  file  to 

cl  I*  Otl’lS  IT  US  92T  • AiSOj  0H9  HOt  C l~lcl  ncj  9 ths  OV7r*02T 

of  a file  with  the  set-user-ID  bit  on,  otherwise 
one  could  create  Trojan  Horses  able  to  misuse 
other's  files. 

FILES 

SEE  ALSO  /etc/uids  has  the  mapping  between  user  names  and 

user  numbers. 

DIAGNOSTICS  The  error  bit  (c-bit)  is  set  on  illegal  owner 

changes . 

BUGS 

OWNER  Ken,  dmr 
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SYS  CLOSE  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


close  — close  a file 


(file  descriptor  in  rO) 

sys  close  / close  = 6. 


Given  a file  descriptor  such  as  returned  from  an 
open  or  creat  call,  close  closes  the  associated 
file,  A close  of  all  files  is  automatic  on  exit, 

1 — . x.  ^ j w v T J ^ i-  ~ ^ 4-  A r\  ~ X «...  - 7 l.  - « - 
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ously  open  files,  close  is  necessary  to  programs 
which  deal  with  many  files. 


creat,  open 

The  error  bit  (c-bit)  is  set  for  an  unknown  file 
descriptor . 

ken,  dmr 
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SYS  CHEAT  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


BUGS 


creat  — create  a new  file 

sys  creat;  name;  mode  / creat  = 8. 

(file  descriptor  in  rO) 

-great  creates  a new  file  or  prepares  to  rewrite 
an  existing  file  called  name ; name  is  the  address 
of  a null-terminated  string.  If  the  file  did  not 
exist,  it  is  given  mode  mode ; if  it  did  exist, 
its  mode  and  owner  remain  unchanged  but  it  is 
truncated  to  0 length. 

The  file  is  also  opened  for  writing,  and  its  file 
descriptor  is  returned  in  rO. 

The  mode  given  is  arbitrary;  it  need  not  allow 
writing . This  feature  is  used  by  programs  which 
deal  with  temporary  files  of  fixed  names.  The 
creation  is  done  with  a mode  that  forbids  writ- 
ing. Then  if  a second  instance  of  the  program 
attempts  a creat.  an  error  is  returned  and  the 
program  knows  that  the  name  is  unusable  for  the 
moment . 

If  the  last  link  to  an  open  file  is  removed  the 
file  is  not  destroyed  until  the  file  is  closed. 


write,  close 

The  error  bit  (c-bit)  may  be  set  if:  a needed 
directory  is  not  readable;  the  file  does  not 
exist  and  the  directory  in  which  it  is  to  be 
created  is  not  writable;  the  file  does  exist  and 
is  unwritable;  the  file  is  a directory. 


OWNER 


ken,  dmr 
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SYS  EXEC  (II) 


NAME 

exec  — execute  a 

file 

SYNOPSIS 

sys  exec;  name; 

args 

name : 

<”.\o> 

args : 
argl  : 

• • • 

argl ; arg2 ; . . . ; 0 
<...\0> 

DESCRIPTION  exec  overlays  the  calling  process  with  the  named 

file,  then  transfers  to  the  beginning  of  the  core 
image  of  the  file.  The  first  argument  to  exec  is 
a pointer  to  the  name  of  the  file  to  be  executed. 
The  second  is  the  address  of  a list  of  pointers 
to  arguments  to  be  passed  to  the  file.  Conven- 
tionally, the  first  argument  is  the  name  of  the 
file.  Each  pointer  addresses  a string  terminated 
by  a null  byte. 

There  can  be  no  return  from  the  file;  the  calling 
core  image  is  lost. 

The  program  break  is  set  from  the  executed  file; 
see  the  format  of  a. out. 

Once  the  called  file  starts  execution,  the  argu- 
ments are  passed  as  follows.  The  stack  pointer 
points  to  the  number  of  arguments.  Just  above 
this  number  is  a list  of  pointers  to  the  argument 
strings. 

sp->  nargs 
argl 
• • • 
argn 

argl : <arg1\0> 

• • • 

argn:  <argn\0> 

The  arguments  are  placed  as  high  as  possible  in 
core:  just  below  60000(8). 

Files  remain  open  across  exec  calls.  However, 
the  illegal  instruction,  emt.  quit,  and  interrupt 
trap  specifications  are  reset  to  the  standard 
values.  (See  ilgins.  cemt.  quit,  intr. ) 

Each  user  has  a real  user  ID  and  an  effective 
(The  real  ID  identifies  the  person  using  the 
system;  the  effective  ID  determines  his  access 
privileges. ) exec  changes  the  effective  user  ID 
to  the  owner  of  the  executed  file  if  the  file  has 
the  "set-user-ID"  mode.  The  real  user  ID  is  not 
affected. 


11/3/71 


SYS  EXEC  (II) 


FILES 

SEE  ALSO  fork 

DIAGNOSTICS  If  the  file  cannot  be  read  or  if  it  is  not  exe- 

cutable, a return  from  exec  constitutes  the  diag- 
nostic. The  error  bit  (c-bit)  is  set. 

BUGS  — 

OWNER  ken,  dmr 
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SYS  EXIT  (II) 


NAME  exit  — terminate  process 

SYNOPSIS  sys  exit  / exit  = 1 

DESCRIPTION  exit  is  the  normal  means  of  terminating  a pro- 

cess. All  files  are  closed  and  the  parent  pro- 
cess is  notified  if  it  is  executing  a wait. 

This  C3. 1 1 can  nsvsr  rsturn* 

FILES 

SEE  ALSO  sys  wait 

DIAGNOSTICS 

BUGS 

OWNER  ken,  dmr 
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SYS  FORK  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


fork  — spawn  new  process 

sys  fork  / fork  = 2. 

(new  process  return) 

(old  process  return) 


fork  is  the  only  way  new  processes  are  created. 
The  new  process's  core  image  is  a copy  of  that  of 
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return  location  and  the  fact  that  rO  in  the  old 


process  contains  the  process  ID  of  the  new  pro- 


cess. This  process  ID  is  used  by  wait. 


sys  wait,  sys  exec 

The  error  bit  (c-bit)  is  set  in  the  old  process 
if  a new  process  could  not  be  created  because  of 
lack  of  swap  space. 

See  wait  for  a subtle  bug  in  process  destruction, 
ken,  dmr 
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SYS  FSTAT'  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


fstat  — get  status  of  open  file 

(file  descriptor  in  rO) 

sys  fstat ; buf  / fstat  = 28. 


This  call  is  identical  to  stat . except  that  it 
operates  on  open  files  instead  of  files  given  by 
name.  It  is  most  often  used  to  get  the  status  of 


w.  1 “ v.  U * VA  -fc.  M Xtl  ^ u 

are  unknown. 


if  mif 
vww^/uv. 


sys  stat 

The  error  bit  (c-bit)  is  set  if  the  file  descrip- 
tor is  unknown. 

ken,  dmr 
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SYS  GETUID  (II) 


NAME  getuid  — get  user  identification 

SYNOPSIS  sys  getuid  / getuid  =24. 

/ i « « « "v*  T TN  4 »»  v*  O \ 
v UOC1  ii/  All  AO  ; 

DESCRIPTION  getuid  returns  the  real  user  ID  of  the  current 

process.  The  real  user  ID  identifies  the  person 
who  is  logged  in,  in  contradistinction  to  the 
effective  user  ID,  which  determines  his  access 
permission  at  each  moment.  It  ist>thus  useful n to 
programs  which  operate  using  the  'set  user  ID 
mode,  to  find  out  who  invoked  them. 

FILES  /etc/uids  can  be  used  to  map  the  user  ID  number 

into  a name. 

SEE  ALSO  setuid 

DIAGNOSTICS 

BUGS 

OWNER  ken,  dmr 
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SYS  GTTY  (II) 


NAME  gtty  — get  typewriter  status 

SYNOPSIS  (file  descriptor  in  rO) 

m • *3  / r-r  4-  +•  * r Q O • V\  4 '3  0 0 AmVi  "1  /■)  V* 

oy  o ml.  ty  9 aiH  / h ui.y  — ^4.  • « uv/  c.  xu  uou 

• * • 

arg:  .=.+6 

DESCRIPTION  gtty  stores  in  the  three  words  addressed  by  arg 

the  status  of  the  typewriter  whose  file  descrip- 
tor  is  given  in  rO.  The  format  is  the  same  as 
that  passed  by  stty. 

FILES 

SEE  ALSO  stty 

DIAGNOSTICS  Error  bit  (c-bit)  is  set  if  the  file  descriptor 

does  not  refer  to  a typewriter. 

BUGS 

OWNER  ken,  dmr 
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SYS  ILGINS  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


ilgins  — catch  illegal  instruction  trap 

sys  ilgins;  arg  / ilgins  = 33.;  not  in  assembler 

ilgins  allows  a program  to  catch  illegal  instruc- 
tion traps.  If  arg  is  zero,  the  normal  instruc- 
tion trap  handling  is  done:  the  process  is  ter- 
minated and  a core  image  is  produced.  If  arg  is 
cl  location  within  ths  program,  control  is  passsd 
to  arg  when  the  trap  occurs. 

This  call  is  used  to  implement  the  floating  point 
simulator,  which  catches  and  interprets  11/45 
floating  point  instructions. 


fptrap.  the  floating  point  package 


OWNER 


ken,  dmr 
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SYS  INTR  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


intr  — set  interrupt  handling 
sys  intr;  arg  / intr  = 27. 


When  arg  is  0,  interrupts  (ASCII  DELETE)  are 
ignored.  When  arg  is  1,  interrupts  cause  their 
normal  result,  that  is,  force  an  exit.  When  arg 
is  a location  within  the  program,  control  is 


j_ii  l.c:x  x 


tip  u 


occurs • 


After  an  interrupt  is  caught,  it  is  possible  to 
resume  execution  by  means  of  an  rt i instruction; 
however,  great  care  must  be  exercised,  since  all 
I/O  is  terminated  abruptly  upon  an  interrupt.  In 
particular,  reads  of  the  typewriter  tend  to  re- 
turn with  0 characters  read,  thus  simulating  an 
end  of  file. 


quit 


It  should  be  easier  to  resume  after  an  interrupt, 
but  I don't  know  how  to  make  it  work. 


OWNER 


ken,  dmr 
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SYS  LINK  (It) 


NAME 

link  — link  to  a file 

SYNOPSIS 

sys  link;  name^ ; name2  / link  = 9. 

DESCRIPTION 

A link  to  name,  is  created;  the  link  has 
name^.  Either 'name  may  be  an  arbitrary 
namet 

name 

path 

FILES 

— 

SEE  ALSO 

unlink 

DIAGNOSTICS 

The  error  bit  (c-bit)  is  set  when  name^  cannot  be 
found:  when  name^  already  exists;  when  the  direc- 
tory  of  name„  cannot  be  written;  when  an  attempt 
is  made  to  link  to  a directory  by  a user  other 
than  the  super-user. 

BUGS 

— 

OWNER 

ken,  dmr 
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SYS  MKDIR  (II) 


NAME  mkdir  — make  a directory 

SYNOPSIS  sys  mkdir;  name;  mode  / mkdir  = 14. 

DESCRIPTION  mkdir  creates  an  empty  directory  whose  name  is 

the  null-terminated  string  pointed  to  by  name. 

The  mode>tof  the  directory  is  mode.  The  special 
entries  and  are  not  present. 

mkdir  can  only  be  invoked  by  the  super-user. 

FILES 

SEE  ALSO  mkdir  command 

DIAGNOSTICS  Error  bit  ( c-bit ) is  set  if  the  directory  already 

exists  or  if  the  user  is  not  the  super-user. 

BUGS 

OWNER  ken,  dmr 


SYS  MOUNT  (II) 


11/3/71 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


mount  — mount  file  system 

sys  mount;  special;  name  / mount  =21.;  not  in  assembler 


mount  announces  to  the  system  that  a removable 
file  system  has  been  mounted  on  special  file 
special;  from  now  on,  references  to  file  name 
will  refer  to  the  root  file  on  the  newly  mounted 
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null-terminated  strings  containing  the  appropri- 
ate path  names. 


Name  must  exist  already.  If  it  had  useful  con- 
tents, they  are  inaccessible  while  the  file  sys- 
tem is  mounted. 


Almost  always,  name  should  be  a directory  so  that 
an  entire  file  system,  not  just  one  file,  may 
exist  on  the  removable  device. 


umount 

Error  bit  (c— bit)  set  if  special  is  inaccessible 
or  dir  does  not  exist. 

At  most  one  removable  device  can  be  mounted  at  a 
time.  The  use  of  this  call  should  be  restricted 
to  the  super-user. 

ken,  dmr 
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SYS  OPEN  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


BUGS 

OWNER 


open  — open  for  reading  or  writing 

sys  open;  name;  mode  / open  = 5. 

(descriptor  in  rO ) 

open  opens  the  file  name  for  reading  (if  mode  is 
0)  or  writing  (if  mode  is  non-zero).  name  is  the 
address  of  a string  of  ASCII  characters 
representing  a path  name,  terminated  by  a null 
character. 

The  file  descriptor  should  be  saved  for  subse- 
quent calls  to  read  (or  write)  and  close. 

In  both  the  read  and  write  case  the  file  pointer 
is  set  to  the  beginning  of  the  file. 

If  the  last  link  to  an  open  file  is  removed,  the 
file  is  not  destroyed  until  it  is  closed. 


creat,  read,  write,  close 

The  error  bit  (c-bit)  is  set  if  the  file  does  not 
exist,  if  one  of  the  necessary  directories  does 
not  exist  or  is  unreadable,  or  if  the  file  is  hot 
readable. 


ken,  dmr 
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SYS  QUIT  (II) 


NAME  quit  — turn  off  quit  signal 

SYNOPSIS  sys  quit;  flag  / quit  = 26. 

DESCRIPTION  When  flag  is  0,  this  call  disables  quit  signals 

from  the  typewriter  (ASCII  FS).  When  flag  is  1, 
quits  are  re-enabled,  and  cause  execution  to 
cease  and  a core  image  to  be  produced.  When  flag 
is  Ctrl  address  in  th©  program,  a quit  causss  con— 
trol  to  be  sent  to  that  address. 

Quits  should  be  turned  off  only  with  due  con- 
sideration. 

FILES 

SEE  ALSO  sys  intr  turns  off  interrupts 

DIAGNOSTICS 

BUGS 

OWNER  ken,  dmr 
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SYS  READ  (II) 


NAME  read  — read  from  file 

SYNOPSIS  (file  descriptor  in  rO ) 

sys  read;  buffer;  nchars  / read  = 3. 

(nread  in  rO) 

DESCRIPTION  A file  descriptor  is  a word  returned  from  a suc- 

cessful open  call. 

Buffer  is  the  location  of  nchars  contiguous  bytes 
into  which  the  input  will  be  placed.  It  is  not 
guaranteed  that  all  nchars  bytes  will  be  read, 
however;  for  example  if  the  file  refers  to  a 
typewriter  at  most  one  line  will  be  returned.  In 
any  event  the  number  of  characters  read  is  re- 
turned in  rO. 

If  rO  returns  with  value  0,  then  end— of-file  has 
been  reached. 


FILES 

SEE  ALSO  open 

DIAGNOSTICS  As  mentioned.  rO  is  0 on  return  when  the  end  of 


the  file  has  been  reached.  If  the  read  was 
otherwise  unsuccessful  the  error  bit  (c-bit)  is 
set.  Many  conditions,  all  rare,  can  generate  an 
error:  physical  I/O  errors,  bad  buffer  address, 
preposterous  nchars . file  descriptor  not  that  of 
an  input  file. 

BUGS 


OWNER 


ken,  dmr 


11/3/71 


SYS  RELE  (II) 


NAME  rele  — release  processor 

SYNOPSIS  sys  rele  / rele  = 0;  not  in  assembler 

DESCRIPTION  This  call  causes  the  process  to  be  swapped  out 

immediately  if  another  process  wants  to  run.  Its 
main  reason  for  being  is  internal  to  the  system, 
namely  to  implement  timer-runout  swaps.  However, 
it  can  be  used  beneficially  by  programs  which 
wish  to  loop  for  some  reason  without  consuming 
more  processor  time  than  necessary. 

FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER  ken,  dmr 


1 1/3/71 


SYS  SEEK  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


seek  — move  read/write  pointer 


(file  descriptor  in  rO) 

— M*  ***  Mi  Mi  1*  * MV  ^ ^ « MV  ■ V\  ** »V  3 m MV 

aya  OCCA  j uJLi-ocu  , pcrnamc 


/ seek 


1 Q 

I M*  • 


The  file  descriptor  refers  to  a file  open  for 
reading  or  writing.  The  read  (or  write)  pointer 
for  the  file  is  set  as  follows: 


if  ptrname  is  0,  the  pointer  is  set  to  offset. 

if  ptrname  is  1 , the  pointer  is  set  to  its 
current  location  plus  offset. 

if  Ptrname  is  2,  the  pointer  is  set  to  the 
size  of  the  file  plus  offset. 


tell 

The  error  bit  (c-bit)  is  set  for  an  undefined 
file  descriptor. 

A file  can  conceptually  be  as  large  as  2**20 
bytes.  Clearly  only  2**16  bytes  can  be  addressed 
by  seek.  The  problem  is  most  acute  on  the  tape 
files  and  RK  and  RF.  Something  is  going  to  be 
done  about  this . 


OWNER 


ken,  dmr 


11/3/71 


SYS  SETUID  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


setuid  — set  process  ID 
(process  ID  in  rO) 

ay  o actuiu  / actuiu  = z.  • 

The  user  ID  of  the  current  process  is  set  to  the 
argument  in  rO.  Both  the  effective  and  the  real 
user  ID  are  set.  This  call  is  only  permitted  to 

■H V\ o cnpgr — near  # 


getuid 

Error  bit  (c-bit)  is  set  if  the  current  user  ID 
is  not  that  of  the  super-user. 


OWNER 


ken,  dmr 


11/3/71 


SYS  SMDATE  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


smdate  — set  modified  date  on  file 


(time  to  AC-MQ) 

M -4—  « • 

D_y  o oiu<aa  wc  « 


/ n rv\ « 

/ UltlVAU  wc 


30 • y not  in  3. sssmti o2T 


File  is  the  address  of  a null-terminated  string 
giving  the  name  of  a file.  The  modified  time  of 
the  file  is  set  to  the  time  given  in  the  AC-MQ 

r*  arr  i c:  4-  ci  r*  <2 
- '**'3  — * 


This  call  is  allowed  only  to  the  super-user. 


Error  bit  is  set  if  the  user  is  not  the  super- 
user  or  if  the  file  cannot  be  found. 


BUGS 

OWNER  Ren,  dmr 


11/3/71 


SYS  STAT  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


stat  — get  file  status 

sys  stat;  name;  buf  / stat  = 18. 


name  points  to  a null-terminated  string  naming  a 
file;  buf  is  the  address  of  a 34(10)  byte  buffer 
into  which  information  is  placed  concerning  the 
file.  It  is  unnecessary  to  have  any  permissions 

■r*  ♦-  si  1 r.-t  ■?  f Vv  r ftcriA  1^4-  4*  /s  4-lso  f 4 1 a Vst  i4*  all  4 ra 

a U UJ.  X n X Ull  x i>  XXV.  y 1-/VA  v.  m J.  v»  j.* 

tories  leading  to  the  file  must  be  readable. 
After  stat . buf  has  the  following  format: 


buf,  +1 
+ 2, +3 
+4 
+5 

+6, +7 
+8, +9 


i -number 

flags  (see  below) 
number  of  links 
user  ID  of  owner 
size  in  bytes 

first  indirect  block  or  contents  block 


+22, +23  eighth  indirect  block  or  contents  block 

+24, +25, +26, +27  creation  time 
+28, +29, +30, +31  modification  time 
+32, +33  unused 


The  flags  are  as  follows: 

100000  used  (always  on) 

040000  directory 

020000  file  has  been  modified  (always  on) 

010000  large  file 

000040  set  user  ID 

000020  executable 

000010  read,  owner 

000004  write,  owner 

000002  read,  non-owner 

000001  write,  non-owner 


fstat 

Error  bit  (c-bit)  is  set  if  the  file  cannot  be 
found . 

The  format  is  going  to  change  someday, 
ken,  dmr 


OWNER 


1 1/3/71 


SYS  STIME  (II) 


NAME 

stime 

— set  time 

SYNOPSIS 

(time 

in  AC-MQ) 

sys 

stime  / stime  = 25.;  not  in  assembler 

DESCRIPTION 

stime 

sets  the  system's  idea  of  the  time  and 

date. 

Only  the  super-user  may  use  this  call. 

IP  TT  r?  c 
X XUDU 

— 

SEE  ALSO 

sys  time 

DIAGNOSTICS 

Error 

user. 

bit  (c-bit)  set  if  user  is  not  the  super- 

BUGS 

— 

OWNER 

ken, 

dmr 

11/3/71 


SYS  STTY  (II) 


NAME 

SYNOPSIS 

arg : 

DESCRIPTION 


T?  TT  p C 
J.  j.ij&i-' 

SEE  ALSO 
DIAGNOSTICS 

BUGS 


stty  — set  mode  of  typewriter 
(file  descriptor  in  rO) 

sys  stty;  arg  / stty  = 31 . ; not  in  assembler 

• • • 

dcrsr;  dcpsr;  mode 


stty  sets  mode  bits  for  a typewriter  whose  file 

1?  -i  r*  c»  4- 


« v 4 v 4 n vn  ri  o r<  o/l  i n y*H 

ucoti  x o j.**  j.  w 


Vi  ^ ctrcf  om 

1 


delays  until  the  typewriter  is  quiescent.  Then, 
the  argument  dcrsr  is  placed  into  the  typewri- 
ter's reader  control  and  status  register,  and 
dcpsr  is  placed  in  the  printer  control  and  status 
register.  The  DC-11  manual  must  be  consulted  for 
the  format  of  these  words.  For^the  purpose  of 
this  call,  the  most  important  role  of  these  argu- 
ments is  to  adjust  to  the  speed  of  the  typewrit- 
er. 


The  mode  arguments  contains  several  bits  which 
determine  the  system's  treatment  of  the 
typewriter: 

200  even  (M37  tty)  parity  allowed 

100  odd  (non-M37  tty)  allowed 

040  raw  mode:  wake  up  on  all  characters 

020  map  CR  into  LF;  echo  LF  or  CR  as  CR-LF 

010  don't  echo  (half  duplex) 

004  map  upper  case  to  lower  case  on  input  (M33  TTY) 

Characters  with  the  wrong  parity,  as  determined 
by  bits  200  and  100,  are  ignored. 

In  raw  mode,  every  character  is  passed  back  im- 
mediately to  the  program.  No  erase  or  kill  pro- 
cessing is  done;  the  end-of-file  character  (EOT), 
the  interrupt  character  (DELETE)  and  the  quit 
character  (FS)  are  not  treated  specially. 

Mode  020  causes  input  carriage  returns  to  be 
turned  into  new-lines;  input  of  either  CR  or  LF 
causes  CR-LF  both  to  be  echoed  (used  for  GE  Ter- 
miNet  300's). 


gtty 

The  error  bit  (c-bit)  is  set  if  the  file  descrip- 
tor does  not  refer  to  a typewriter. 

This  call  should  be  used  with  care.  It  is  all 
too  easy  to  turn  off  your  typewriter. 

ken,  dmr 


OWNER 


11/3/71 


SYS  TELL  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO. 

DIAGNOSTICS 


BUGS 

OWNER 


tell  — get  file  pointer 
(file  descriptor  in  rO) 

J ■»  T . _ r£ x.  - — x-  ^ _ on 

ays  u ti_L  x 5 unset  j ptmamc  / — xv* 

(value  returned  in  rO) 

The  file  descriptor  refers  to  an  open  file.  The 
value  returned  in  rO  is  one  of: 

if  ptrname  is  0,  the  value  returned  is  offset; 

if  ptrname  is  1 , the  value  is  the  current 
pointer  plus  offset ; 

if  ptrname  is  2,  the  value  returned  is  the 
number  of  bytes  in  the  file  plus  offset. 


seek 

The  error  bit  (c-bit)  is  set  if  the  file  descrip- 
tor is  unknown. 

Tell  doesn't  work.  Complain  if  you  need  it. 
ken,  dmr 


11/3/71 


SYS  TIME  ( tf) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


time  returns  the  time  since  00:00:00,  Jan.  1, 

1971,  measured  in  sixtieths  of  a second.  The 
high  order  word  is  in  the  AC  register  and  the  low 
qttH or"  is  in  the  MQ. 


The  chronological-minded  user  will  note  that 
2**32  sixtieths  of  a second  is  only  about  2.5 
years . 

ken,  dmr 


11/3/71 


SYS  UMOUNT  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


umount  — dismount  file  system 

sys  umount;  special  / umount  = 22.;  not  in  assembler 

umount  announces  to  the  system  that  special  file 
special  is  no  longer  to  contain  a removable  file 
system.  The  file  associated  with  the  special 
file  reverts  to  its  ordinary  interpretation  (see 

mnnnf  ^ 

w / • 

The  user  must  take  care  that  all  activity  on  the 
file  system  has  ceased. 


mount 

Error  bit  (c-bit)  set  if  no  file  system  was 
mounted  on  the  special  file. 

Use  of  this  call  should  be  restricted  to  the 
super-user. 

ken,  dmr 


11/3/71 


SYS  UNLINK  (II) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 


BUGS 


OWNER 


unlink  — remove  directory  entry 
sys  unlink;  name  / unlink  = 10. 


Name  points  to  a null-terminated  string.  Unlink 
removes  the  entry  for  the  file  pointed  to  by  name 
from  its  directory.  If  this  entry  was  the  last 
link  to  the  file,  the  contents  of  the  file  are 


rrvt 

• m wx  wjr  w v»*  i 


T f 

Urn  Am  | * AW  TX  W V W J-  | 


the  file  was  open  in  any  process,  the  actual  des- 
truction is  delayed  until  it  is  closed,  even 
though  the  directory  entry  has  disappeared. 


link 

The  error  bit  (c-bit)  is  set  to  indicate  that  the 
file  does  not  exist  or  that  its  directory  cannot 
be  written.  Write  permission  is  not  required  on 
the  file  itself.  It  is  also  illegal  to  unlink  a 
directory  (except  for  the  super-user). 

Probably  write  permission  should  be  required  to 
remove  the  last  link  to  a file,  but  this  gets  in 
other  problems  (namely,  one  can  donate  an  un- 
deletable  file  to  someone  else). 

If  the  system  crashes  while  a file  is  waiting  to 
be  deleted  because  it  is  open,  the  space  is  lost. 

ken,  dmr 


11/3/71 


SYS  WAIT  (II) 


NAME  wait  — wait  for  process  to  die 

SYNOPSIS  sys  wait  / wait  = 7. 

(process  ID  in  rO) 

DESCRIPTION  wait  causes  its  caller  to  delay  until  one  of  its 

child  processes  terminates.  If  any  child  has 
already  died,  return  is  immediate;  if  there  are 
no  children,  return  is  immediate  with  the  error 
bit  set.  In  the  case  of  several  children  several 
waits  are  needed  to  learn  of  all  the  deaths. 

FILES 

SEE  ALSO  fork 

DIAGNOSTICS  error  bit  (c-bit)  on  if  no  children  not  previous- 

ly waited  for. 

BUGS  A child  which  dies  but  is  never  waited  for  is  not 

really  gone  in  that  it  still  consumes  disk  swap 
and  system  table  space.  This  can  make  it  impos- 
sible to  create  new  processes.  The  bug  can  be 
noticed  when  several  & separators  are  given  to 
the  shell  not  followed  by  an  command  without  an 
ampersand.  Ordinarily  things  clean  themselves  up 
when  an  ordinary  command  is  typed,  but  it  is  pos- 
sible to  get  into  a situation  in  which  no  com- 
mands are  accepted,  so  no  waits  are  done;  the 
system  is  then  hung. 

The  fix,  probably,  is  to  have  a new  kind  of  fork 
which  creates  a process  for  which  no  wait  is 
necessary  (or  possible);  also  to  limit  the  number 
of  active  or  inactive  descendants  allowed  to  a 
process, 

ken,  dmr 


OWNER 


11/3/71 


SYS  WRITE  (If) 


NAME  write  — write,  on  file 

SYNOPSIS  (file  descriptor  in  rO) 

t.t  ■»  4-  /~\  * f ar  • nnViare  / t.i  ri  f q — A 

w»y  vj  n J.  J.  ) MU-L-  W-L  ) lis-nv**.  u f Jk-  _l_  W V_  — * • 

(number  written  in  rO) 

DESCRIPTION  A file  descriptor  is  a word  returned  from  a suc- 

cessful open  or  creat  call. 

buffer  is  the  address  of  nchars  contiguous  bytes 
which  are  written  on  the  output  file.  The  number 
of  characters  actually  written  is  returned  in  rO. 
It  should  be  regarded  as  an  error  if  this  is  not 
the  same  as  requested. 

For  disk  and  tape  files,  writes  which  are  multi- 
ples of  512  characters  long  and  begin  on  a 
512-byte  boundary  are  more  efficient  than  any 
others . 

FILES 

SEE  ALSO  sys  creat,  sys  open 

DIAGNOSTICS  The  error  bit  (c-bit)  is  set  on  an  error:  bad 

descriptor,  buffer  address,  or  count,  physical 
I/O  errors; 

BUGS 

ken,  dmr 


OWNER 


11/3/71 


ATOF  (III) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


atof  — ascii  to  floating 


jsr 


r 5, atof;  subr 


atof  will  convert  an  ascii  stream  to  a floating 
number  returned  in  frO.  The  subroutine  subr  is 
called  on  r5  for  each  character  of  the  ascii 
stream.  subr  should  return  the  character  in  rO. 


left  in  rO.  The  floating  point  simulation  should 
be  active  in  either  floating  or  double  mode,  but 
in  single  precision  integer  mode. 

kept  in  /etc/liba.a 


fptrap 


The  subroutine  subr  should  not  disturb  any  regis- 
ters . 


OWNER 


ken 


11/3/71 


ATOI  (III) 


NAME  atoi  — ascii  to  integer 

SYNOPSIS  jsr  rS.atoi;  subr 

DESCRIPTION  atoi  will  convert  an  ascii  stream  to  a binary 

number  returned  in  mq.  The  subroutine  subr  is 
called  on  r5  for  each  character  of  the  ascii 
stream,  subr  should  return  the  character  in  rO, 
The  first  character  not  used  in  the  conversion  is 
left  in  rO. 

FILES  kept  in  /etc/liba.a 

SEE  ALSO 

DIAGNOSTICS 

BUGS  The  subroutine  subr  should  not  disturb  any  regis- 

ters . 

OWNER  ken 


11/3/71 


GTIME  (III) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


-""A/V  trv 


ctime  — convert  date  and  time  to  ASCII 

(move  time  to  AC-MQ) 
mov  $buffer,rO 

isr  pc. ctime 

The  buffer  is  15  characters  long.  The  time  has 
the  format 

Oct  9 17:32:24 

The  input  time  is  in  the  AC  and  MQ  registers  in 
the  form  returned  by  sys  time . 

kept  in  /etc/liba.a 

ptime,  to  print  time;  sys  time 


The  time  is  not  taken  modulo  1 year.  (Jan  1 
comes  out  Dec  32.)  Also,  the  clock  period  is  only 

-a  1 r--  1 O ■f  Tr<t  ^ r“  C 

C3  w -i.  w ' — ■ m-  y w i.  i— - • 


Hrnr- 


11/3/71 


EXP  (III) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


exp  — exponential  function 
jsr  r5,exp 

The  exponential  of  frO  is  returned  in  frO.  The 
floating  point  simulation  should  be  active  in 
either  floating  or  double  mode,  but  in  single 
precision  integer  mode, 

kept  in  /etc/liba.a 

f ptrap 


Large  arguments  will  cause  an  overflow  fault  from 
the  floating  point  simulator. 

ken 


11/3/71 


FPTRAP  (III) 


NAME  fptrap  — floating  point  simulator 

SYNOPSIS  sys  33. ; fptrap 

DESCRIPTION  fptrap  is  a program  designed  to  pick  up  illegal 

instruction  in  order  to  simulate  a sub-set  of  the 
11/45  floating  point  hardware. 

FILES  kept  in  /etc/liba.a 

SEE  ALSO  as,  PDP-11/45  manual 

DIAGNOSTICS  none,  hardware  gives  no  diagnostics. 

BUGS  The  simulation,  if  unsuccessful  for  any  reason 

gives  an  IOT  fault  from  inside  the  simulator. 

This  should  be  handeled  better. 

OWNER  ken,  dmr 


11/3/71 


FTOA  (III) 


NAME  ftoa  — floating  to  ascii  conversion 

SYNOPSIS  jsr  r 5, ftoa;  subr 

DESCRIPTION  ftoa  will  convert  the  floating  point  number  in 

frO  into  ascii  in  the  form  [-] d . dddddddde [-] dd* . 
The  floating  point  simulator  should  be  active  in 
either  floating  or  double  mode,  but  in  single 
integer  mode.  For  each  character  generated  by 
ftoa,  the  subroutine  subr  is  called  on  register 
r5  with  the  character  in  rO. 

FILES  kept  in  /etc/liba.a 

SEE  ALSO  fptrap 

DIAGNOSTICS 

BUGS  The  subroutine  subr  should  not  disturb  any  regis- 

ters . 

OWNER  ken 


11/3/71 


GETW , GETC,  FOPEN  (ill) 


NAME 

SYNOPSIS 


DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


getw,  getc,  fopen  — buffered  input 

mov  $filename,rO 

isr  r5.fODen:  iobuf 

~ » A.  I 

J ^ r- 

J fc>i  i KJLIU1 

(character  in  rO) 


jsr  r5,getw;  iobuf 

(word  in  rO) 


These  routines  are  used  to  provide  a buffered 
input  facility.  iobuf  is  the  address  of  a 
134(10)  byte  buffer  area  whose  contents  are  main- 
tained by  these  routines.  Its  format  is: 


ioptr:  .=.+2  / 

.=.+2  / 

. =.  +2  / 

.=.+128.  / 


file  descriptor 
characters  left  in  buffer 
ptr  to  next  character 
the  buffer 


fopen  should  be  called  initially  to  open  the 
file.  On  return,  the  error  bit  (c-bit)  is  set  if 

the  open  failed.  If  f open  is  never  called , vet 

will  read  from  the  standard  input  file. 


getc  returns  the  next  byte  from  the  file  in  rO. 
The  error  bit  is  set  on  end  of  file  or  a read 
error . 


getw  returns  the  next  word  in  rO.  qe tc  and  getw 
may  be  used  alternately;  there  are  no  odd/even 
problems . 

iobuf  must  be  provided  by  the  user;  it  must  be  on 
a word  boundary. 

kept  in  /etc/liba.a 

sys  open,  sys  read;  putc,  putw,  fereat 
c-bit  set  on  EOF  or  error 


for  greater  speed,  the  buffer  should  be  512  bytes 
long.  Unfortunately,  this  will  cause  several 
existing  programs  to  stop  working. 


OWNER 


dmr 


11/3/71 


ITOA  (III) 


NAME  itoa  — integer  to  ascii  conversion 

SYNOPSIS  jsr  r5,itoa;  subr 

DESCRIPTION  itoa  will  convert  the  number  in  rO  into  ascii 

decimal  possibly  preceded  by  a - sign.  For  each 
character  generated  by  itoa,  the  subroutine  subr 
is  called  on  register  r5  with  the  character  in 

■~r\ 

-i-  w ♦ 

FILES  kept  in  /etc/liba.a 

SEE  ALSO 

DIAGNOSTICS 

BUGS  The  subroutine  subr  should  not  disturb  any  regis- 

ters . 

OWNER  ken 


11/3/71 


LOG  (III) 


NAME 

log  — logarithm  base  e 

SYNOPSIS 

jsr  r5,log 

DESCRIPTION 

The  logarithm  base  e of  frO  is  returned  in  frO 

mi_  „ vvyv  -i  4-  r-»  ■!  i +-  A x->vn  euVnnl  Vn  "3  «'"■’+•  *i  t r <Tj 

X X it;  lxuauiny  L oxiuuxulxou  isiiwu-lu  >^v_-  ^ ^ ^ j.  v ^ 

either  floating  or  double  mode,  but  in  single 
precision  integer  mode. 

FILES 

kept  in  /etc/liba.a 

SEE  ALSO 

fptrap 

DIAGNOSTICS 

The  error  bit  (c-bit)  is  set  if  the  input  argu 
ment  is  less  than  or  equal  to  zero. 

BUGS 

— 

OWNER 

ken 

o o 
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MESG  (III) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


mesg  — write  message  on  typewriter 

jsr  r5,mesg;  <Now  is  the  time\0>;  .even 

mesa  writes  the  string  immediately  following  its 
call  onto  the  standard  output  file.  The  string 
is  terminated  by  a 0 byte. 

kept  in  /etc/liba.a,  standard  output  file 


ken,  dmr 
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PTIME  (III) 


NAME  ptime  — print  date  and  time 

SYNOPSIS  (move  time  to  ac-mq) 

on  ^ “4  1 tt*  A 

lliU  V J_  O.CS  9 JL  W 

j sr  pc , pt ime 

DESCRIPTION  ptime  prints  the  date  and  time  in  the  form 

Oct  9 17:20:33 

on  the  file  whose  file  descriptor  is  in  rO.  The 
string  is  15  characters  long.  The  time  to  be 
printed  is  placed  in  the  AC  and  MQ  registers  in 
the  form  returned  by  sys  time . 

FILES  kept  in  /etc/liba.a 

SEE  ALSO  sys  time,  ctime  (used  to  do  the  conversion) 

DIAGNOSTICS 

BUGS  see  ctime 

OwIn  iiK  cirri x f K6n 
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PUTC , PUTW,  FCREAT , FLUSH  (III) 


NAME 

SYNOPSIS 


DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


putc,  putw,  fcreat,  flush  — buffered  output 

mov  $filename,rO 

j sr  r5 , fcreat  j icbuf 

(get  byte  in  rO) 

jsr  r5,putc;  iobuf 

( rro  4-  ir  i n v~  H \ 

\ '3'—  ^ " v'-4-  -i.  / 

jsr  r5,putw;  iobuf 

jsr  r5, flush;  iobuf 

fcreat  creates  the  given  file  (mode  17)  and  sets 
up  the  buffer  iobuf  (size  134(10)  bytes);  putc 
and  putw  write  a byte  or  word  respectively  onto 
the  file;  flush  forces  the  contents  of  the  buffer 
to  be  written,  but  does  not  close  the  file.  The 

■f  v*m  ^ t-  4-Vi  o "Wnff  or  S o • 


iobuf : 

.=.  + 2 

/ 

file  descriptor 

. =.  +2 

/ 

characters  unused  in  buffer 

. = . + 2 

/ 

ptr  to  next  free  character 

.-.+128, 

/ 

buf 1 ex 

fcreat  sets  the  error  bit  (c-bit)  if  the  file 
creation  failed;  none  of  the  other  routines  re- 
turn error  information. 


Before  terminating,  a program  should  call  flush 
to  force  out  the  last  of  the  output. 

The  user  must  supply  iobuf . which  should  begin  on 
a word  boundary. 

kept  in ■ /et-c/liba. a 

sys  creat;  sys  write;  getc,  getw,  fopen 
error  bit  possible  on  fcreat  call 
buffers  should  be  changed  to  512  bytes. 


OWNER 


dmr 
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SIN,  COS  (III) 


NAME  sin,  cos  — sine  cosine 

SYNOPSIS  jsr  r5,sin  (cos) 

DESCRIPTION  The  sine  (cosine)  of  frO  (radians)  is  returned  in 

frO.  The  floating  point  simulation  should  be 
active  in  either  floating  or  double  mode,  but  in 
single  precision  integer  mode.  All  floating 
registers  are  used. 

FILES  kept  in  /etc/liba.a 

SEE  ALSO  fptrap 

DIAGNOSTICS 

BUGS  Size  of  the  argument  should  be  checked  to  make 

sure  the  result  is  meaningful. 

OWN  ER  ke  n , dmr 
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SWITCH  (III) 


NAME 

SYNOPSIS 

swtab: 

DESCRIPTION 

FILES 

SEE  ALSO 

DIAGNOSTICS 

huOc 

OWN  ER 


switch  — switch  on  value 
(switch  value  in  rO) 

J m v %-  C r-T.rn  +r«Vs  • n r.r+-  2 "h 

| O X 1.  J j kJ  »*A  UVU  ) «_i  mr  v- 

(not-found  return) 

• • • 

vail ; labl ; 

• • < * 

1 n • 1 

V V-.  — W J — 

. . ; 0 

switch  compares  the  value  of  rO  against  each  of 
the  val . ; if  a match  is  found,  control  is 
transferred  to  the  corresponding  la^  (after  pop- 
ping the  stack  once).  If  no  match  has  been  found 
by  the  time  a null  labi  occurs,  switch  returns. 

kept  in  /etc/liba.a 


ken,  dmr 
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/DEV/MEM  (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


mem  — core  memory 


mem  maps  the  core  memory  of  the  computer  into  a 
file.  It  may  be  used,  for  example,  to  examine, 
and  even  to  patch  the  system  using  the  debugger. 

Mem  is  a byte— oriented  file?  its  bytes  are  num- 
bered 0 to  65,535. 


If  a location  not  corresponding  to  implemented 
memory  is  read  or  written,  the  system  will  incur 
a bus-error  trap  and,  in  panic,  will  reboot  it- 
self . 


OWNER 


Ken,  dmr 
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/DEV/PPT  (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


ppt  — punched  paper  tape 


ppt  refers  to  the  paper  tape  reader  or  punch, 
depending  on  whether  it  is  read  or  written. 

When  ppt  is  opened  for  writing,  a 100-character 
leader  is  punched.  Thereafter  each  byte  written 
is  punched" on  the  tape.  No  editing  of  the  char- 
acters is  performed.  When  the  file  is  closed,  a 
100-character  trailer  is  punched. 

When  ppt  is  opened  for  reading,  the  process  waits 
until  tape  is  placed  in  the  reader  and  the  reader 
is  on-line.  Then  requests  to  read  cause  the 
characters  read  to  be  passed  back  to  the  program, 
again  without  any  editing.  This  means  that 
several  null  characters  will  usually  appear  at 
the  beginning  of  the  file;  they  correspond  to  the 
tape  leader.  Likewise  several  nulls  are  likely 
to  appear  at  the  end.  End-of-file  is  generated 
when  the  tape  runs  out. 

Seek  calls  for  this  file  are  meaningless  and  are 
effectively  ignored  ^nowever,  the  read/wiite 
pointers  are  maintained  and  an  arbitrary  sequence 
of  reads  or  writes  intermixed  with  seeks  will 
give  apparently  correct  results  when  checked  with 
tell) . 


lbppt , dbppt , bppt  format 


Previously,  there  were  separate  special  files  for 
ASCII  tape  (which  caused  null  characters  to  be 
suppressed)  and  binary  tape  (which  used  a blocked 
format  with  checksums).  These  notions  were  con- 
ceptually quite  attractive,  but  they  were  dis- 
carded to  save  space  in  the  system. 


OWNER 


vren,  dmr 
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/DEV/RFQ  (IV) 


NAME  rfO  — RF11-RS11  fixed-head  disk  file 

SYNOPSIS 

DESCRIPTION  This  file  refers  to  the  entire  RF  disk.  It  may 

be  either  read  or  written,  although  writing  is 
inherently  very  dangerous,  since  a file  system 
resides  there. 

The  disk  contains  1024  256-word  blocks,  numbered 
0 to  1023.  Like  the  other  block-structured  dev- 
ices (tape,  RK  disk)  this  file  is  addressed  in 
blocks,  not  bytes.  This  has  two  consequences: 
seek  calls  refer  to  block  numbers,  not  byte 
numbers;  and  sequential  reading  or  writing  always 
advance  the  read  or  write  pointer  by  at  least  one 
block.  Thus  successive  reads  of  10  characters 
from  this  file  actually  read  the  first  10  charac- 
ters from  successive  blocks, 

FILES 

SEE  ALSO  ,/dev/tapQ,  /dev/rkO 

DIAGNOSTICS 

BUGS  The  fact  that  this  device  is  addressed  in  terms 

of  blocks,  not  bytes,  is  extremely  unfortunate. 

It  is  due  entirely  to  the  fact  that  read  and 
write  pointers  (and  consequently  the  arguments  to 
seek  and  tell ) are  single-precision  numbers. 

This  really  has  to  be  changed  but  unfortunately 
the  repercussions  are  serious. 

ken,  dmr 


OWNER 
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/DEV/RKO  (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


rkO  — RK03  (or  RK05)  disk 


rkO  refers  to  the  entire  RK03 
sequentially-addressed  file, 
are  numbered  0 to  4871 . Like 
tape  files,  its  addressing  is 
Consult  the  /dev/rfO  section. 


/dev/rfO,  /dev/tapO 


See  /dev/rfO 
ken,  dmr 


disk  as  a single 
Its  256-word  blocks 
the  RF  disk  and  the 
block-oriented . 


owner 
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/DEV/TAPO 


• • • 


TAP 7 (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 
DIAGNOSTICS 

BUGS 


tapO  . . . tap7 


These  files  refer  to  DECtape  drives  0 to  7 . 

Since  the  logical  drive  number  can  be  manually 
set,  all  eight  files  exist  even  though  at  present 
there  are  only  two  physical  drives. 

The  256-word  blocks  on  a standard  DECtape  are 
numbered  0 to  577.  However,  the  system  makes  no 
assumption  about  this  number;  a block  can  be  read 
or  written  if  it  exists  on  the  tape  and  not  oth- 
erwise. An  error  is  returned  if  a transaction  is 
attempted  for  a block  which  does  not  exist. 

Like  the  RK  and  RF  special  files,  addressing  on 
the  tape  files  is  block-oriented.  See  the  RFO 
section. 


/dev/rfO,  /dev/rkO 


see  /dev/rfO 


OWNER 


ken,  dmr 
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/DEV/TTY  (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


tty  — console  typewriter 


tty  (as  distinct  from  ttyQ.  . ..,  tty5)  refers  to 
the  console  typewriter  hard-wired  to  the  fDf-1 1 . 
Most  of  the  time  it  is  turned  off  and  so  has  lit- 
tle general  use. 

Generally,  the  disciplines  involved  in  dealing 
with  tty  are  similar  to  those  for  ttyQ  ...  and 
the  appropriate  section  should  be  consulted.  The 
following  differences  are  salient; 

The  system  calls  stty  and  gtty  do  not  apply  to 
this  device.  It  cannot  be  placed  in  raw  mode;  on 
input,  upper  case  letters  are  always  mapped  into 
lower  case  letters;  a carriage  return  is  echoed 
when  a line-feed  is  typed. 

The  quit  character  is  not  FS  (as  with ^ttyO . . . ) n 
but  is  generated  by  the  key  labelled  "alt  mode. 

By  appropriate  console  switch  settings,  it  is 
possible  to  cause  UNIX  to  come  up  as  a single- 
user  system  with  I/O  on  this  device. 


/dev/ttyO . . . ; init 


OWNER 


ken,  dmr 
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/DEV/TTYO 


• • • 


TTY 5 (IV) 


NAME 

SYNOPSIS 

DESCRIPTION 


ttyO  . . . tty5  — communications  interfaces 


These  files  refer  to  DC1 1 asynchronous  communica- 
tions interfaces.  At  the  moment  there  are  six  of 
them,  but  the  number  is  subject  to  change.  Names 
for  up  to  four  others  will  be  constructed  by  an 
obvious  algorithm. 

When  one  of  these  files  is  opened,  it  causes  the 
process  to  wait  until  a connection  is  esta- 
blished. (In  practice,  however,  user's  programs 
seldom  open  these  files;  they  are  opened  by  init 
and  become  a user's  standard  input  and  output 
file.)  The  very  first  typewriter  file  open  in  a 
process  becomes  the  control  typewriter  for  that 
process.  The  control  typewriter  plays  a special 
role  in  the  handling  quit  or  interrupt  signals, 
as  discussed  below.  The  control  typewriter  is 
inherited  by  a child  process  during  a fork. 

A terminal  associated  with  one  of  these  files 
ordinarily  operates  in  full-duplex  mode.  Charac- 
ters may  be  typed  at  any  time,  even  while  output 
xs  occurring,  ana  are  omy  lost  wnen  tne  system's 
character  input  buffers  become  completely  choked, 
which  is  very  rare. 

When  first  opened,  the  interface  expects  the  ter- 
minal to  use  15  odd-parity,  10-bit  ASCII  charac- 
ters per  second  and  to  have  the  new-line  func- 
tion. Finally,  the  system  calculates  delays 
after  sending  the  code  for  certain  functions 
(e.g.,  new-line,  tab)  on  the  assumption  that  the 
terminal  is  a Teletype  model  37.  All  this  is 
merely  a long  way  of  saying  that  the  system  ex- 
pects to  be  used  by  a TTY  37.  However,  most  of 
these  assumptions  can  be  changed  by  a special 
system  call:  in  particular,  the  expected  parity 
can  be  changed;  the  speed,  character  size,  and 
stop  bits  can  be  changed  (speeds  available  are 
134.5,  150,  300,  1200  baud;  see  the  DC 11  manual); 
the  new-line  function  can  be  simulated  by  a com- 
bination of  the  carriage-return  and  line-feed 
functions;  carriage  return  can  be  translated  into 
new-line  on  input;  upper  case  letters  can  be 
mapped  into  lower  case  letters;  echoing  can  be 
turned  off  so  the  terminal  operates  in  half  du- 
plex. See  the  system  call  stty . (Also  see  init 
for  the  way  300-baud  terminals  are  detected.) 

Normally,  a typewriter  operates  in  units  of 
lines.  This  means  that  a program  attempting  to 
read  will  be  suspended  until  an  entire  line  has 
been  typed.  Also,  no  matter  how  many  characters 
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/DEV/TTYO  ...  TTYS  (IV) 


are  requested  in  the  read  call,  at  most  one  line 
will  be  returned.  It  is  not  however  necessary  to 
read  a whole  line  at  once;  any  number  of  charac- 

Vavi-i  -i  r~s  a roar!  mro 

O IKUj'  MC  i.  Jkli  V*  w*i-  I 

without  losing  information. 


The  EOT  character  may  be  used  to  generate  an  end 
of  file  from  a typewriter.  When  an  EOT  is  re- 
ceived, all  the  characters  waiting  to  be  read  are 
immediately  passed  to  the  program,  without  wait- 
ing for  a new-line.  Thus  if  there  are  no  charac- 
ters waiting,  which  is  to  say  the  EOT  occurred  at 
the  beginning  of  a line,  zero  characters  will  be 
passed  back,  and  this  is  the  standard  end-of-file 
signal. 

When  the  carrier  signal  from  the  dataset  drops 
(usually  because  the  user  has  hung  up  his  termi- 
nal) any  read  returns  with  an  end-of-file  indica- 
tion. Thus  programs  which  read  a typewriter  and 
are  sensitive  to  end-of-file  on  their  inputs 
(which  all  programs  whould  be)  will  terminate 
appropriately  when  hung  up  on. 

Two  characters  have  a special  meaning  when^typed. 
ThettASClI  DEL  character  ^ sometimes  called  "ruo- 
out" ) is  the  interrupt  signal.  When  this  charac- 
ter is  received  from  a given  typewriter,  a search 
is  made  for  all  processes  which  have  this  type- 
writer as  their  control  typewriter,  and  which 
have  not  informed  the  system  that  they  wish  to 
ignore  interrupts.  If  there  is  more  than  one 
such  process,  one  of  these  is  selected,  for  prac- 
tical purposes  at  random.  Then  either  the  pro- 
cess is  forced  to  exit  or  a trap  is  simulated  to 
an  agreed-upon  location  in  the  process.  See  sys 
intr  for  more  information. 

The  ASCII  character  FS  is  the  quit  signal.  Its 
treatment  is  identical  to  the  interrupt  signal 
except  that  unless  the  receiving  process  has  made 
other  arrangements  it  will  not  only  be  terminated 
but  a core  image  file  will  be  written.  (See  sys 
quit  for  more  information.) 

During  input,  erase  and  kill  processing  is  nor- 
mally done.  The  character  "#  erases  the  last 
character  typed,  except  that  it  will  not  erase 
beyond  the f beginning  of  a line  or  an  EOF.  The 
character  kills  the  entire  line  up  to  the 

point  where  it  was  typed,  but  not  beyond  an  EOF. 
Both  these  characters  operate  on  a keystroke 
basis  independently  of  any  backspacing  or  tabbing 
that  may  have  been  done.  Either  or  "#"  may 

be  entered  literally  by  preceding  it  by  i the 
erase  or  kill  character  remains,  but  the  \ 
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/dev/ttyq 
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TT5f5  (IV) 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


disappears. 

It  is  also  possible  (again  by  sys  stty)  to  put 
the  typewriter  into  raw  mode.  In  this  mode,  the 
program  reading  is  wakened  on  each  character,  and 
when  a program  reads,  it  waits  only  until  at 
least  one  character  has  been  typed.  In  raw  mode, 
no  erase  or  kill  processing  is  done;  and  the  EOT, 
emit  and  interruDt  characters  are  not  treated 

~Jk  ~ *■ 

specially. 

Output  is  prosaic  compared  to  input.  It  should 
be  noted,  however,  that  when  one  or  more  charac- 
ters are  written,  they  are  actually  transmitted 
to  the  terminal  as  soon  as  previously-written 
characters  have  finished  typing.  When  a program 
produces  characters  too  rapidly  to  be  typed,  as 
is  very  common,  it  may  be  suspended  for  a time. 

Odd  parity  is  always  generated  on  output,  except 
that  the  characters  EOT  and  NAK  have  the  wrong 
parity.  Thus  the  37  TTY  will  not  hang  up  (EOT) 
or  lock  its  keyboard  (NAK)  if  a program  acciden- 
tally prints  these  characters. 


tty 


As  has  been  suggested,  UNIX  has  a heavy  predispo- 
sition towards  37  Teletype  terminals.  However, 
it  is  quite  possible  to  use  300-baud  terminals 
such  as  the  GE  TermiNet  300.  (See  init  for  the 
procedure.)  The  main  difficulty  in  practice  is 
37-oriented  delay  calculations. 

Terminals  such  as  the  IBM  2741  would  theoretical- 
ly be  very  desirable  but  there  are  many  difficul- 
ties related  to  its  inadequate  and  non-ASCII 
character  sets  (the  2741  has  two,  count  'em)  and 
the  inherently  half-duplex  nature  of  the  termi- 
nal. It  is  possible  to  produce  output  on  a 2741 ; 
cf  type. 


OWNER 


ken,  dmr 
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A. OUT  (V) 


NAME 

SYNOPSIS 

DESCRIPTION 


a. out  — assembler  and  link  editor  output 


a. out  is  the  output  file  of  the  assembler  as  and 
the  link  editor  lu.  In  both  cases,  a. out  is  exe- 
cutable provided  there  were  no  errors  and  no 
unresolved  external  references. 

This  file  has  four  sections:  a header,  the  pro- 
gram text,  a symbol  table,  and  relocation  bits. 
The  last  two  may^be^empty  if  the  program  was 
loaded  with  the  ”-s"  option  of  Id  or  if  the  sym- 
bols and  relocation  have  been  removed  by  strip. 

The  header  always  contains  6 words: 

1 a "br  .+14"  instruction  (205(8)) 

2 The  size  of  the  program  text 

3 The  size  of  the  symbol  table 

4 The  size  of  the  relocation  bits  area 

5 The  size  of  a data  area 

6 A zero  word  (unused  at  present) 

The  sizes  of  the  program,  symbol  table,  and  relo- 
cation area  are  in  bytes  but  are  always  even. 

The  branch  instruction  serves  both  to  identify 
the  file  and  to  jump  to  the  text  entry  point. 

The  program  text  size  includes  the  6-word  header. 

The  data  area  is  used  when  the  file  is  executed; 
the  exec  system  call  sets  the  program  break  to 
the  sum  of  the  text  size  and  this  data  size.  The 
data  area  is  generated  by  the  assembler  when  the 
location  counter  lies  beyond  the  last  assem- 

bled data,  for  example  when  the  program  ends>twith 
one  or  more  constructions  of  the  form  , = .+n  ; it 
is  preserved  by  the  loader  for  the  last  program 
in  a load.  (Routines  other  than  the  last  have 
the  appropriate  number  of  0 words  inserted,  since 
there  is  no  other  provision  for  zero- suppress ion 
in  an  a. out  file. ) 

The  symbol  table  consists  of  6-word  entries.  The 
first  four  contain  the  ASCII  name  of  the  symbol, 
null-padded.  (In  fact,  the  assembler  generates 
symbols  of  at  most  7 bytes.)  The  next  word  is  a 
flag  indicating  the  type  of  symbol.  The  follow- 
ing values  are  possible: 

00  undefined  symbol 

01  absolute  symbol 

02  register  symbol 

03  relocatable  symbol 

40  undefined  global  symbol 

41  absolute  global  symbol 
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A. OUT  (V) 


43  relocatable  global  symbol 

An  undefined  global  corresponds  to  a GMAP  "sym- 
r ef ' and  an  absolute  or  relocatable  global  to  a 
“symdef”  or  absolute  or  relocatable  value  respec- 
tively, Values  other  than  those  given  above  may 
occur  if  the  user  has  defined  some  of  his  own 
instructions. 

The  last  word  of  a symbol  table  entry  contains 
the  value  of  the  symbol.  Its  contents  are  not 
specified  if  the  symbol  is  undefined. 

If  a. out  contains  no  unresolved  global  refer- 
ences, header  and  text  portions  are  exactly  as 
they  will  appear  in  core  when  the  file  is  execut- 
ed. If  the  value  of  a word  in  the  text  portion 
involves  a reference  to  an  undefined  global,  the 
word  is  replaced  by  the  offset  in  the  symbol 
table  of  the  appropriate  symbol.  (That  is,  pos- 
sible offsets  are  0,  12(10),  24(10),  ....)  Such  a 
word  will  have  appropriate  relocation  bits. 

The  relocation  bits  portion  uses  a variable- 

length  encoding.  There  is  a string  of  bits  for 
each  word  in  the  text  portion.  The  scheme  has  at 

least  two  bits  for  each  word,  plus  possibly  two 
more  to  extend  the  codes  available;  in  either 
case  the  bits  may  be  followed  by  a 16-bit  string 
to  represent  an  offset  to  an  external  symbol. 

The  bits  are  packed  together  without  regard  to 
word  boundaries.  The  last  word  is  filled  out 
with  0's  on  the  right. 

The  possible  relocation  bit  configurations  are: 

00 

word  is  absolute 

01 

word  is  relocatable 

10 

word  is  a relative  reference  to  an  undefined 
global  symbol  with  no  offset.  Currently,  the 
word  contains  the  offset  in  the  symbol  table 
of  the  symbol.  When  the  symbol  becomes  de- 
fined, say  with  value  xA  this  location  will 
contain  x-.-2,  where  ".  is  the  location  of 
the  word. 

1 1 OOxxxxxxxxxxxxxxxx 

word  is  a relative  reference  to  an  external 
symbol  with  an  offset.  It  is  the  same  as  the 
previous  relocation  type,  except  that  the 
16-bit  offset  is  added  in  when  the  symbol 
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FILES 

SEE  ALSO 

DIAGNOSTICS 

DTlfC 


becomes  defined. 


1101 


-»  r»  a v a v-  or>  ^ an  nn^  a-F  *i  to  ovf  Orn  al 
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symbol  with  no  offset.  At  present  the  word 
contains  the  symbol  table  offset  of  the  sym- 
bol. When  the  symbol  becomes  defined,  the 
word  will  contain  the  value  of  the  symbol. 


Ill Oxxxxxxxxxxxxxxxx 

word  is  a reference  to  an  undefined  external 
symbol  with  an  offset.  At  present,  the  word 
contains  the  symbol  table  offset  of  the  sym- 
bol. When  the  symbol  becomes  defined,  the 
word  will  contain  the  value  of  the  symbol 
plus  the  given  16-bit  offset. 


as  Id.  strip,  nm.  un 


Soon,  there  will  be  a new  type  of  symbol?  the 
data  area  symbol.  m tne  text,  it  will  appear  as 
an  ordinary  external  reference.  However,  it  need 
not  be  defined;  this  will  be  done  by  the  loader. 
Watch  this  space  for  more  details. 


OWNER 


dmr 
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NAME  archive  (library)  file  format 

SYNOPSIS 

DESCRIPTION  The  archive  command  ar  is  used  to  combine  several 

files  into  one.  Its  use  has  three  benefits:  when 
files  are  combined,  the  file  space  consumed  by 
the  breakage  at  the  end  of  each  file  (256  bytes 
on  the  average)  is  saved:  directories  are  smaller 
and  less  confusing;  archive  files  of  object  pro- 
grams may  be  searched  as  libraries  by  the  loader 
Id. 

A file  produced  by  ax  has  a "magic  number"  at  the 
start,  followed  by  the  constituent  files,  each 
preceded  by  a file  header.  The  magic  number  is 
-147(1°) f or  177555(8)  (it  was  chosen  to  be  un- 
likely to  occur  anywhere  else).  The  header  of 
each  file  is  16  bytes  long: 

0-7 

file  name,  null  padded  on  the  right 

6-11 

Modification  time  of  the  file 

12 

User  ID  of  file  owner 
1 3 

file  mode 

14-15 

file  size 

If  the  file  is  an  odd  number  of  bytes  long,  it  is 
padded  with  a null  byte,  but  the  size  in  the 
header  is  correct. 

Notice  there  is  no  provision  for  empty  areas  in 
an  archive  file. 

FILES 

SEE  ALSO  ar,  Id 

DIAGNOSTICS 

BUGS 

ken , dmr 


OWNER 


11/3/71 


BPPT  (V) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


binary  punched  paper  tape  format 


Binary  paper  tape*  is  used  to  pass  and  store  arbi- 
trary information  on  paper  tape.  The  format 
chosen  has  the  following  features:  a)  no  format 
of  the  data  is  assumed.  b)  check  summing  c)  zero 

flimnrpfisinn 

c z — 

The  format  is  as  follows: 

Between  records,  NULL  characters  are  ignored. 

The  beginning  of  the  tape  is  considered  between 
records,  thus  the  leader  is  ignored. 

The  first  non-null  character  specifies  the  type 
and  size  of  the  record.  If  the  character  is 
positive  (1  to  177),  the  record  is  a data  record 
consisting  of  that  many  characters.  All  but  the 
last  of  these  characters  are  data,  the  last  being 
a checksum.  The  checksum  is  calculated  such  that 
the  sum  of  the  entire  record  is  zero  mod  256. 

If  the  first  character  is  negative  (200-376)  the 
record  is  a zero  suppression  record.  It  is 
identical  to  minus  that  number  of  zeros  of  data. 
One  character  of  checksum  follows  this  negative 
character.  It  is  the  positive  of  the  negative 
character. 

The  special  case  of  a record  looking  like  a sin- 
gle zero  character  suppressed  ( 377 ; 1 ) causes  no 
data  transfer,  but  is  an  end-of-file  indication. 


lbppt,  dbppt 


ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 


format  of  core  image 


Three  conditions  cause  UNIX  to  write  out  the  core 
image  of  an  executing  programs  the  program  gen— 
erates  an  unexpected  trap  (by  a bus  error  orn 
illegal  instruction);  the  user  sends  a "quit" 
signal  (which  has  not  been  turned  off  by  the 
program) ; a trap  is  simulated  by  the  floating 
point  simulator.  The  core  image  is  called  "core 
and  is  written  in  the  current  working  directory 
(provided  it  can  be;  normal  access  controls  ap- 
ply). it  is  exactly  8192+64  bytes  long.  The 
first  8192  represent  the  actual  contents  of 
memory  at  the  time  of  the  fault;  the  last  64  are 
the  contents  of  the  system's  per-user  data  area 
for  this  process.  Only  the  first  word  of  this 
area  will  be  described. 

When  any  trap  which  is  not  an  I/O  interrupt  oc- 
curs, all  the  useful  registers  are  stored  on  the 
stack.  After  all  the  registers  have  been  stored, 

+•  p cent  ent  s of  $p  sre  Dl3.c0di  in  tih0  first  csll 
of  +hp  user  area;  this  cell  is  called  u.  sp . 
inereiure,  within  the  sjuxe  nuayc  piupci  , thei  c xo 

an  area  which  contains  the  following  registers  in 
the  following  order  (increasing  addresses): 

( u . sp ) — > sc 
mq 
a c 
r5 
r4 
r3 
r2 
rl 
rO 

pc  (at  time  of  fault) 

processor  status  (at  time  of  fault) 

The  last  two  are  stored  by  the  hardware.  It  fol- 
lows that  the  contents  of  s£  at  the  time  of  the 
fault  were  (u.sp)  plus  22(10). 

The  t-bit  (trap  bit)  in  the  stored  status  will  be 
on  when  a quit  caused  the  generation  of  the  core 
image,  since  this  bit  is  used  in  the  implementa- 
tion of  quits. 


DIAGNOSTICS 
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BUGS 

OWNER  ken,  dmr 


11/3/71 


DIRECTORY  (V) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


format  of  directories 


A directory  behaves  exactly  like  an  ordinary 
file,  save  that  no  user  may  write  into  a directo- 
ry. The  fact  that  a file  is  a directory  is  indi- 
cated by  a bit  in  the  flag  word  of  its  i-node 

pnt-  rv  . 

u . 

Directory  entries  are  10  bytes  long.  The  first 
word  is  the  i-node  of  the  file  represented  by  the 
entry,  if  non-zero;  if  zero,  the  entry  is  empty. 

Bytes  2-9  represent  the  (8-character)  file  name, 
null  padded  on  the  right.  These  bytes  are  not 
necessarily  cleared  for  empty  slots. 

By  convention,  the  first  two  entries  in  each 
directory  are  for  and  " . , ’ . The  first  is  an 

entry  for  the  directory  itself.  The  second  is 
for  the  parent  directory.  The  meaning  of  is 

modified  for  the  root  directory  of  the  master 
file  system  and  for  the  root  directories  of  re- 
movable file  systems.  In  the  first  case,  there 
is  no  parent,  and  in  the  second,  the  system  does 
not  permit  off-device  references  without  a mount 
system  call.  Therefore  in  both  cases  has 

the  same  meaning  as 


file  system  format 


OWNER 


ken,  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


format  of  file  system 


Every  file  system  storage  volume  (e.g.  RF  disk, 

RK  disk,  DEC tape  reel)  has  a common  format  for 
certain  vit&l  information. 

Every  such  volume  is  divided  into  a certain 
number  of  256  word  (512  byte)  blocks.  Blocks  0 
and  1 are  collectively  known  as  the  super-block 
for  the  device;  they  define  its  extent  and  con- 
tain an  i-node  map  and  a free- storage  map.  The 
first  word  contains  the  number  of  bytes  in  the 
free-storage  map;  it  is  always  even.  It  is  fol- 
lowed by  the  map.  There  is  one  bit  for  each 
block  on  the  device;  the  bit  is  1 if  the  block 
is  free.  Thus  if  the  number  of  free-map  bytes  is 
n,  the  blocks  on  the  device  are  numbered  0 
through  8n-1 . The  free-map  count  is  followed  by 
the  free  map  itself.  The  bit  for  block  k of  the 
device  is  in  byte  k/8  of  the  map;  it  is  offset 
k(mod  8)  bits  from  the  right.  Notice  that  bits 
exist  for  the  superblock  and  the  i-list,  even 
though  they  are  never  allocated  or  freed. 

After  the  free  map  is  a word  containing  the  byte 
count  for  the  i— node  map.  It  too  is  always  even. 
I-numbers  below  41(10)  are  reserved  for  special 
files,  and  are  never  allocated;  the  first  bit  in 
the  i-node  free  map  refers  to  i-number  41. 
Therefore  the  byte  number  in  the  i— node  map  for 
i-node  i is  (i-41)/8.  It  is  offset  (i-41  ) (mod 
8)tibits  from  the  right;  unlike  the  free  map,  a 
"6"  bit  indicates  an  available  i-node. 

I-numbers  begin  at  1 , and  the  storage  for  i-nodes 
begins  at  block  2.  Also,  i-nodes  are  32  bytes 
long,  so  16  of  them  fit  into  a block'.  Therefore, 
i-node  _i  is  located  in  block  (i+31)/16  of  the 
file  system,  and  begins  32  * ( (i.+31  ) (mod  16))  bytes 
from  its  start. 

There  is  always  one  file  system  which  is  always 
mounted;  in  standard  UNIX  it  resides  on  the  RF 
disk.  This  device  is  also  used  for  swapping. 

The  swap  areas  are  at  the  high  addresses  on  the 
device.  It  would  be  convenient  if  these  ad- 
dresses did  not  appear  in  the  free  list,  but  in 
fact  this  is  not  so.  Therefore  a certain  number 
of  blocks  at  the  top  of  the  device  appear  in  the 
free  map,  are  not  marked  free,  yet  do  not  appear 
within  any  file.  These  are  the  blocks  that  show 
up  "missing"  in  a check  of  the  RF  disk. 

Again  on  the  primary  file  system  device,  there 
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are  several  pieces  of  information  following  that 
previously  discussed.  They  contain  basically  the 
information  typed  by  the  tm  command;  namely,  the 
times  spent  since  a cold  boot  in  various  ca- 
tegories, and  a count  of  I/O  errors.  In  particu- 


T av 

-L  «-*A.  f 


(measured  since  00:00  Jan  1,  1971);  two  words 
with  the  time  spent  executing  in  the  system;  two 
words  with  the  time  spent  waiting  for  I/O  on  the 
RF  and  RK  disks;  two  words  with  the  time  spent 
executing  in  a user's  core;  one  byte  with  the 
count  of  errors  on  the  RF  disk;  and  one  byte  with 
the  count  of  errors  on  the  RK  disk.  All  the 
times  are  measured  in  sixtieths  of  a second. 


I-node  41(10)  is  reserved  for  the  root  directory 
of  the  file  system.  No  i-numbers  other  than  this 
one  and  those  from  1 to  40  (which  represent  spe- 
cial files)  have  a built-in  meaning.  Each  i-node 
represents  one  file.  The  format  of  an  i-node  is 
as  follows,  where  the  left  column  represents  the 
offset  from  the  beginning  of  the  i-node: 


0 - 1 


2 


f 1 aq  s 


V*  o ] i.T  i 


number  of  links 


—*  u.3c:i.  ID  OX  OWii  6i 

4-5  size  in  bytes 

6-7  first  indirect  block  or  contents  block 


• • • 

20-21  eighth  indirect  block  or  contents  block 
22-25  creation  time 
26-29  modification  time 
30-31  unused 


The  flags  are  as  follows: 


100000  i-node  is  allocated 
040000  directory 

020000  file  has  been  modified  (always  on) 

010000  large  file 

000040  set  user  ID  on  execution 

000020  executable 

000010  read,  owner 

000004  write,  owner 

000002  read,  non-owner 

000001  write,  non-owner 


The  allocated  bit  (flag  100000)  is  believed  even 
if  the  i-node  map  says  the  i-node  is  free;  thus 
corruption  of  the  map  may  cause  i-nodes  to  become 
unallocatable,  but  will  not  cause  active  nodes  to 
be  reused. 


Byte  number  n of  a file  is  accessed  as  follows:  n 
is  divided  by  512  to  find  its  logical  block 
number  (say  b)  in  the  file.  If  the  file  is  small 
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(flag  010000  is  0),  then  b must  be  less  than  8, 
and  the  physical  block,  number  corresponding  to  b 
is  the  bth  entry  in  the  address  portion  of  the 


If  the  file  is  large,  b is  divided  by  256  to 
yield  a number  which  must  be  less  than  8 (or  the 
file  is  too  large  for  UNIX  to  handle).  The 
corresponding  slot  in  the  i— node  address  portion 
gives  the  physical  block  number  of  an  indirect 
block.  The  residue  mod  256  of  b is  multiplied  by 
two  (to  give  a byte  offset  in  the  indirect  block) 
and  the  word  found  there  is  the  physical  address 
of  the  block  corresponding  to  b. 

If  block  b in  a file  exists,  it  is  not  necessary 
that  all  blocks  less  than  b exist.  A zero  block 
number  either  in  the  address  words  of  the  i-node 
or  in  an  indirect  block  indicates  that  the 
corresponding  block  has  never  been  allocated. 

Such  a missing  block  reads  as  if  it  contained  all 
zero  words. 

FILES  — - 

SEE  ALSO  format  of  directories 

DIAGNOSTICS 

BUGS  Two  blocks  are  not  enough  to  handle  the  i-  and 

free-storage  maps  for  an  RP02  disk  pack,  which 
contains  around  10  million  words. 


OWNER 
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NAME  passwd  — password  file 

SYNOPSIS 

DESCRIPTION  passwd  contains  for  each  user  the  following 

information : 

name  (login  name) 
ns  sr word 

C " 

numerical  user  ID 
default  working  directory 
program  to  use  as  Shell 

This  is  an  ASCII  file.  Each  field  within  each 
user's  entry  is  separated  from  the  next  by  a 
colon.  Each  user  is  separated  from  the  next  by  a 
new-line.  If  the  password  field  is  null,  no 
password  is  demanded;  if  the  Shell  field  is  null, 
the  Shell  itself  is  used. 

This  file,  naturally,  is  inaccessible  to  anyone 
but  the  super-user. 

This  file  r G S X ^ fc  w x i X 01  x X y v ^ r ^ v*  • 

FILES 

SEE  ALSO  /etc/in it 

DIAGNOSTICS 

BUGS 

OWNER  super-user 
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NAME  /etc/uids  — map  user  names  to  user  IDs 

SYNOPSIS 

DESCRIPTION  This  file  allows  programs  to  map  user  names  into 

user  numbers  and  vice  versa.  Anyone  can  read  it. 
It  resides  in  directory  /etc,  and  should  be  up- 
dated along  with  the  password  file  when  a user  is 
added  or  deleted. 

The  format  is  an  ASCII  name,  followed  by  a colon, 
followed  by  a decimal  ASCII  user  ID  number. 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


dmr,  ken 


OWNER 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


/tmp/utmp  — user  information 


This  file  allows  one  to  discover  information 
about  who  is  currently  using  UNIX.  The  file,  is 
binary;  each  entry  is  16(10)  bytes  long.  The 
first  eight  bytes  contain  a user's  login  name  or 


ara  rm  1 1 -J-F  f Vio  f aV>l 


y-Ai  i 


order  byte  of  the  next  word  contains  the  last 
character  of  a typewriter  name  (currently,  '0'  to 
'5'  for  /dev/ttyO  to  /dev/tty5).  The  next  two 
words  contain  the  user's  login  time.  The  last 
word  is  unused. 


This  file  resides  in  directory  /tmp. 


/etc/init,  which  maintains  the  file. 


ken,  dmr 


OWNER 
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NAME  basic  — DEC  supplied  BASIC 

SYNOPSIS  basic  [file] 

DESCRIPTION  Basic  is  the  standard  BASIC  V000  distributed  as  a 

stand  alone  program.  The  optional  file  argument 
is  read  before  the  console.  See  DEC-1 1 — AJPB-D 
manual . 

Since  bas  is  smaller  and  faster,  basic  is  not 
maintained  on  line. 

FILES 

SEE  ALSO  bas 

DIAGNOSTICS  See  manual 

rznv 

JJ  WVJU  k 

OWNER  dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 


bj  — the  game  of  black  jack 
/usr/games/bj 

Black  jack  is  a serious  attempt  at  simulating  the 
dealer  in  the  game  of  black  jack  (or  twenty-one) 
as  might  be  found  in  Reno. 

The  following  rules  apply: 

The  bet  is  $2  every  hand. 

A player  'natural'  (black  jack)  pays  $3.  A 
dealer  natural  loses  $2.  Both  dealer  and 
player  naturals  is  a 'push'  (no  money  ex- 
change). 

If  the  dealer  has  an  ace  up,  the  player  is 
allowed  to  make  an  'insurance'  bet  against  the 
chance  of  a dealer  natural.  If  this  bet  is 
not  taken,  play  resumes  as  normal.  If  the  bet 
is  taken,  it  is  a side  bet  where  the  player 
wins  $2  if  the  dealer  has  a natural  and  loses 
$1  if  the  dealer  does  not, 

ir  the  player  xs  dealt,  two  caias  of  the  same 

value,  he  is  allowed  to  'double'.  He  is  al- 
lowed to  play  two  hands,  each  with  one  of 
these  cards.  (The  bet  is  doubled  also;  $2  on 
each  hand. ) 

If  a dealt  hand  has  a total  of  ten  or  eleven, 
the  player  may  'double  down'.  He  may  double 
the  bet  ($2  to  $4)  and  receive  exactly  one 
more  card  on  that  hand. 

Under  normal  play,  the  player  may  'hit'  (draw 
a card)  as  long  as  his  total  is  not  over 
twenty-one.  If  the  player  'busts'  (goes  over 
twenty-one),  the  dealer  wins  the  bet. 

When  the  player  'stands'  (decides  not  to  hit), 
the  dealer  hits  until  he  attains  a total  of 
seventeen  or  more.  If  the  dealer  busts,  the 
player  wins  the  bet. 

If  both  player  and  dealer  stand,  the  one  with 
the  largest  total  wins.  A tie  is  a push. 

The  machine  deals  and  keeps  score.  The  following 
questions  will  be  asked  at  appropriate  times. 

Each  question  is  answered  by  y followed  by  a new 
line  for  'yes',  or  just  new  line  for  'no'. 

? means  'do  you  want  a hit?' 

In sureance? 
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Double  down? 

Every  time  the  deck  is  shuffled,  the  dealer  so 
states  and  the  'action'  (total  bet)  and  'stand- 
ing' (total  won  or  loss)  is  printed.  To  exit, 
hit  the  interrupt  key  (DEL)  and  the  action  and 
standing  will  be  printed. 


SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER  Ren 
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NAME  cal  — print  calendar 

SYNOPSIS  /usr/ken/cal  year 

DESCRIPTION  Cal  will  print  a calendar  for  the  given  year. 

The  year  can  be  between  0 (really  1 BC)  and  9999. 
For  years  when  several  calendars  were  in  vogue  in 
different  countries,  the  calendar  of  England  (and 
therefore  her  colonies)  is  printed. 

P.S.  try  cal  of  1752. 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER  ken 
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NAME 

SYNOPSIS 

DESCRIPTION 


chess  — the  game  of  chess 
/usr/ games/chess 

Chess  is  an  attempt  at  computer  chess.  The  pro- 
gram 'speaks'  in  algebraic  chess  notation.  The 
initial  board  configuration  in  this  notation  is 
as  follows: 
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P 

P 

P 

P 

P 

6 

— 

* 

— 

— 

# 

— 

* 

5 

* 

_ 

— 

* 

— 

* 

_ 

4 

_ 

_ 

* 

_ 

* 

— 

# 

3 

* 

— 

* 

— 

# 

— 

* 

— 

2 
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P 

P 

P 

P 

P 

P 

P 

1 

r 

n 

b 

q 

k 

b 

n 

r 

a 

b 

c 

d 

e 

f 

g 

h 

A move  is  specified  by  the  'from'  co-ordinate 
followed  by  the  'to'  co-ordinate.  Thus  the  white 
P-K4  move  would  be  'e2e4'.  The  black  P-K4  would 
be  ' e7e5  ' . 

The  following  commands  are  recognized  by  the 
chess  program: 

move 

Make  the  move  if  legal.  The  program  does  not 
keep  track  of  who  is  to  play.  The  move  is 
made  for  what  ever  side  is  specified. 

move  x 

Make  the  move  regardless  of  legality.  This  is 
a good  way  to  either  set  up  a desired  situa- 
tion or  to  cheat.  The  initial  move  'e2e8x'  is 
a winner. 

mw 

The  program  will  compute  and  make  a move  for 
the  white  pieces. 

m 

The  program  will  compute  and  make  a move  for 
the  black  pieces. 

lab 

Set  the  level  parameters  to  a and  b,  where  a 
and  b are  numbers  between  0 and  9.  The  ini- 
tial settings  are  2 and  8.  The  first  parame- 
ter increases  computation  time  rapidly  while 
the  second  parameter  only  increases  computa- 
tion exponentially.  Currently  move  times  run 
from  20  seconds  to  10  minutes.  It  was  hoped 
that  these  numbers  would  be  usefully  related 
to  the  program's  competence. 
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CHESS  (VI) 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 


JS 

The  board  is  printed, 
u 

The  last  move  is  un-made.  This  is  another 
good  way  to  cheat. 

t' 

All  the  moves  to  date  are  printed. 

_s 

The  current  game  situation  is  saved  on  the 
file  c.tmp. 

r 

The  game  situation  on  the  file  c.tmp  is  re- 
stored. 

I command 

The  unix  command  is  executed  by  the  mini- 
shell . 

An  interrupt  (DEL)  will  pull  the  program  out  of 
its  computation.  If  it  is  trying  to  make  a move, 

the  best  move  to  date  is  made, 

c.tmp 

msh 

? if  an  illegal  move  is  attempted,  or  if  an  un- 
known command  is  typed. 

The  current  version  does  not  recognize  castling, 
promotion  and  en  passant.  A new  version  is  in 
the  mill. 


OWNER 


ken 
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DAS  (VI) 


NAME  das  — disassembler 

SYNOPSIS 

DESCRIPTION  A PDP-11  disassembler  exists.  Contact  the  author 

for  more  information. 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER  ken 
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DLI  (VI) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


dli  — load  DEC  binary  paper  tapes 
dli  output  [input] 

dli  will  load  a DEC  binary  paper  tape  into  the 
output  file.  The  binary  format  paper  tape  is 
read  from  the  input  file  (/dev/ppt  is  default.) 

/ dev/not 

I - ~ ' t JT  *T 

"checksum" 

dmr 
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DPT  (VI) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


dpt  — read  DEC  ASCII  paper  tape 
dpt  output  [input] 

dpt  reads  the  input  file  (/dev/ppt  default)  as- 
suming the  format  iS  a DEC  generated  ASCII  paper 
tape  of  an  assembly  language  program.  The  output 
is  a UNIX  ASCII  assembly  program. 

/dev/ppt 


Almost  always  a hand  pass  is  required  to  get  a 
correct  output. 

ken  t dmr 
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MOO  (VI) 


NAME 

SYNOPSIS 
DESCRIPTION 
FILES 
CTTT?  aT.cn 

DIAGNOSTICS 

BUGS 

OWNER 


moo  — a game 
/usr/games/moo 

moo  is  a guessing  game  imported  from  England. 


ken 
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SORT  (VI) 


NAME  sort  — sort  a file 

SYNOPSIS  sort  input  output 

DESCRIPTION  sort  will  sort  the  input  file  and  write  the  sort- 

ed file  on  the  output  file.  Wide  options  are 
available  on  collating  sequence  and  ignored  char- 
acters . 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER  dmr,  ken 
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TTT  (VI) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS  . 

OWNER 


ttt  — tic-tac-toe 


/usr/games/ttt 


evtJiyv'<2_ 


0 

ttt  is  the  X's  and  O's  the  is-  popular  in  1st 
grade.  This  is  a learning  program  that  never 
makes  the  same  mistake  twice. 


ttt.k  — old  mistakes 


ken 
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/ETC/AS  2 (VII) 


NAME  as2  — assembler  pass  2 

SYNOPSIS 

DESCRIPTION  as2  is  invoked  by  the  assembler  as  to  perform  its 

second  pass. 

FILES  see  as 

SEE  ALSO  as 

DIAGNOSTICS  see  as 

BUGS 

OWNER  dmr 
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/ETC/ASCII  (VII) 


NAME  ascii  — map  of  ASCII  character  set 

SYNOPSIS  cat  /etc/ascii 


DESCRIPTION  ascii  is  a map  of  the  ASCII  character  set,  to  be 

printed  as  needed.  It  contains: 


iOOQ 

nul 

1001 

soh 

1002 

stx 

003 

etx 

1004 

eot 

1005 

enq 

1006 

ack 

1007 

bel  1 

1 A 4 A 

jUlU 

1 r\  A 4 

| V 1 » 

n-  ±— 
11  U 

1 A4  A 

j U 1 

— i 

IU 

A 4 A 

U 1 3 

vt 

1 A4  A 

j \J  1 H 

rip 

1 A 4 C 

i U 1 3 

c r 

1 A4  /* 

|UI  D 

30 

1 A 4 A 

lU  1 / 

si  j 

|020 

die 

1021 

del 

1022 

dc2 

023 

dc3 

1024 

dc4 

1025 

nak 

[026 

syn 

1027 

etbj 

J 030 

can 

1031 

em 

1032 

sub 

033 

esc 

1034 

f s 

1035 

gs 

1036 

rs 

[037 

us  1 

1040 

sp 

1041 

J 

1042 

043 

# 

1044 

$ 

1045 

% 

1046 

& 

1047 

* | 

1050 

( 

1051 

) 

1052 

* 

053 

+ 

1054 

» 

1055 

- 

1056 

• 

10.57 

7 i 

1060 

0 

1061 

1 

1062 

2 

063 

3 

1064 

4 

1065 

5 

1066 

6 

1067 

7 1 

1070 

8 

1071 

9 

1072 

• 

• 

073 

• 

9 

1074 

< 

1075 

zz 

107  6 

> 

1077 

? 1 

1 1 00 

8 

1101 

A 

1102 

B 

1 03 

C 

1104 

D 

1105 

E 

1106 

F 

1107 

G j 

ilio 

H 

1111 

I 

1112 

J 

1 1 3 

K 

,'114 

L 

11  15 

M 

1116 

N 

1117 

o 1 

1 1 20 

P 

1 1 21 

Q 

i 1 22 

R 

1 23 

S 

1 1 24 

T 

1 1 25 

U 

11  26 

V 

11  27 

w 1 

1 a o r\ 

j 1 3U 

X 

i 4 *3  A 

| 1 J 1 

V 

X 

1 A -A  "A 

| 1 36 

Z 

1 33 

r 

L 

11  34 

V 

\ 

n 35 

J 

1136 

11  37 

1140 

% 

11  41 

a 

1 142 

b 

143 

C 

[144 

d 

1145 

e 

1146 

f 

1 1 47 

9 1 

1 1 50 

h 

1 1 51 

i 

11  52 

j 

1 53 

k 

1154 

1 

11  55 

m 

1156 

n 

{157 

o 1 

1 1 60 

P 

i 1 61 

q 

11  62 

r 

1 63 

s 

11  64 

t 

! 1 65 

u 

H 66 

V 

11  67 

W 1 

1 1 70 

X 

1 1 71 

y 

! 1 72 

z 

! 1 73 

{ 

11  74 

i 

i 

M 75 

} 

11  76 

1177 

del  | 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER  jfo 
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/ETC/BA  (VII) 


NAME 

ba  — B assembler 

SYNOPSIS 

/etc/ba  name 

DESCRIPTION 

ba  is  invoked  by  the  B command  in  order  to  turn 
the  B intermediate  code  into  assembly  language. 

FILES 

* 

name.i  (input),  name.s  (output) 

SEE  ALSO 

b command,  /etc/bc 

DIAGNOSTICS 

— 

BUGS 

At  the  moment,  the  b command  is  defunct,  and  ba 
is  invoked  via  a command  file. 

OWNER 

ken 
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/ETC/BC  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


be  — B compiler 
/etc/bc  name.b  name.i 


be  is  the  B compiler  proper 
into  intermediate  code.  It 
command. 


it  turns  B source 
i 5 invoked  front  the 


name.b  (input),  name.i  (intermediate  output) 
b (command) , /etc/ba 


The  b command  is  defunct  at  the  moment;  be  is 
called  from  a command  file. 

ken 
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/ETC/BILIB  (VII) 


NAME  bilib  — B interpreter  library 

SYNOPSIS 

DESCRIPTION  bilib  is  the  library  of  B runtime  operators.  It 

is  searched  during  the  loading  of  a B-compilea 
program. 

Standard  B subroutines  are  contained  in 
/etc/libb.a. 

FILES 

SEE  ALSO  b (command);  ar,  Id 

DIAGNOSTICS 

BUGS  The  following  assignment  binary  operators  are 

missing:  bl  02  ( = !),  bl  03  (=&),  bl  04  (===),  bl  05 
( = ! = ),  bl  06  (=<=),  bl  07  (=<),  bl  1 0 (=>=),  bill 
( = »,  bl  1 2 (=»),  bl  1 3 (=«),  bl  20  (=/). 


OWNER 


ken,  dmr 


BOOT  PROCEDURES  (VII ) 


bos,  maki,  rom,  vcboot,  msys , et  al 


On  the  RF  disk,  the  highest  1 6K  words  are 
reserved  for  stand-alone  programs.  These  1 6K 
words  are  allocated  as  follows: 

bos  (IK) 

Warm  UNIX  (6K) 

Cold  UNIX  ( 6K ) 

unassigned  (3K) 

The  UNIX  read  only  memory  (ROM)  is  home  cut  with 
2 programs  of  16  words  each.  The  first  (address 
173700)  reads  bos  from  the  RF  disk  into  core 
location  54000  and  transfers  to  54000.  The  other 
ROM  program  (address  173740)  reads  a DECtape  sit- 
ting in  the  end-zone  on  drive  0 into  core  loca- 
tion 0 and  transfers  to  0.  This  latter  operation 
is  compatible  with  part  of  DEC's  standard  ROM. 

The  disassembled  code  for  the  UNIX  ROM  follows: 


173700:  mov 

$177472, r0 

1 2700 ; 1 77472 

mov 

$3 , -( rO ) 

1 2740; 3 

mov 

S j 40000 ,-iiu; 

1 2740 ; 1 40000 

mov 

$54000, -(r0) 

1 2740; 54000 

mov 

$-2000, ~(r0) 

12740; 176000 

mov 

$5,-(r0 ) 

1 2740 ; 5 

tstb 

(r0) 

105710 

bge 

.-2 

2376 

jmp 

*$54000 

137; 54000 

173740:  mov 

$1773 50, rO 

1 270Q;1  77350 

clr 

-(rO) 

5040 

mov 

rO ,- ( rO ) 

10040 

mov 

$3 ,-(r0) 

1 2740 ; 3 

tstb 

(rO) 

105710 

bge 

.-2 

2376 

tst 

*$177350 

5737; 1 77350 

bne 

• 

1 377 

movb 

$5, ( rO) 

11  2710;5 

tstb 

(rO) 

105710 

bge 

.-2 

2 376 

clr 

pc 

5007 

11/3/71 

NAME 

SYNOPSIS 

DESCRIPTION 


The  program  bos  (Bootstrap  Operating  System) 
examines  the  console  switchs  and  executes  one  of 
several  internal  programs  depending  on  the  set- 
ting. If  no  setting  is  recognizable,  bos  loops 
waiting  for  a recognizable  setting.  The  follow- 
ing settings  are  currently  recognized: 

173700 

73700  Will  read  Warm  UNIX  from  the  RF  into  core 
location  0 and  transfer  to  400. 
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BOOT  PROCEDURES  (VII) 


1 Will  read  Cold  UNIX  from  the  RF  into  core 
location  0 and  transfer  to  400. 

2 Will  read  the  unassigned  3K  program  into 
core  location  0 and  transfer  to  400. 

10  Will  dump  1 2K  words  of  memory  from  core 

location  0 onto  DECtape  drive  7. 

0 Will  load  a standard  UNIX  binary  paper 

tape  into  core  location  0 and  transfer  to 

0. 

57500  Will  load  the  standard  DEC  absolute  and 
binary  loaders  and  transfer  to  57500. 

Thus  we  come  to  the  UNIX  warm  boot  procedure:  put 
173700  into  the  switches,  push  load  address  and 
then  push  start.  The  alternate  switch  setting  of 
73700  that  will  load  warm  UNIX  is  used  as  a sig- 
nal to  bring  up  a single  user  system  for  special 
purposes.  See  / etc/ i nit. 

Cold  boots  can  be  accomplished  with  the  Cold  UNIX 
program,  but  they're  not.  Thus  the  Cold  UNIX 
slot  on  the  RF  may  have  any  proyram  desired. 

This  slot  is,  however,  used  during  a cold  boot. 
Mount  the  UNIX  INIT  DECtape  on  drive  0 posi^S^- 
tioned  in  the  end-zone.  Put  173740  into  the 
switches.  Push  load  address . Put  1 into  the 
switches.  Push  start.  This  reads  a program 
called  vc boot  from  the  tape  into  core  location  0 
and  transfers  to  it.  vcboot  then  reads  1 6K  words 
from  the  DECtape  (blocks  1-32)  and  copies  the 
data  to  the  highest  1 6K  words  of  the  RF.  Thus 
this  initializes  the  read-only  part  of  the  RF. 
vcboot  then  reads  in  bos  and  executes  it.  bos 
then  reads  in  Cold  UNIX  and  executes  that.  Cold 
UNIX  halts  for  a last  chance  before  it  completely 
initializes  the  RF  file  system.  Push  continue, 
and  Cold  UNIX  will  initialize  the  RF.  It  then 
sets  into  execution  a user  program  that  reads  the 
DECtape  for  initialization  files  starting  from 
block  33.  When  this  is  done,  the  program  exe- 
cutes / etc/init  which  should  have  been  on  the 
tape . 

The  INIT  tape  is  made  by  the  program  maki  running 
under  UNIX.  maki  writes  vcboot  on  block  0 of 
/ dev/ tap7 . It  then  copies  the  RF  1 6K  words 
(using  /dev/rfO)  onto  blocks  1 thru  32.  It  has 
internally  a list  of  files  to  be  copied  from 
block  33  on.  This  list  follows: 

/ etc/init 
/ bin/chmod 
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BOOT  PROCEDURES  (VII) 


FILES 
SEE  ALSO 

DIAGNOSTICS 

BUGS 


/bin/chown 
/bin/cp 
/bin/ln 
/bin/  Is 
/bin/mkdir 

/ V\  s m t r 


/bin/rrn 
/bin/rmdir 
/bin/ sh 
/bin/stat 
/bin/ tap 


Thus  this  is  the  set  of  programs  available  after 
a cold  boot,  /etc/init  and  /bin/sh  are  mandato- 
ry. /bin/ tap  and  /bin/mkdir  are  used  to  load  up 
the  file  system.  The  rest  of  the  programs  are 
frosting.  As  soon  as  possible,  an  sdate  should 
be  done . 


The  last  link  in  this  incestuous  daisy  chain  is 
the  program  msys . 

msys  char  file 

will  copy  the  file  file  onto  the  RF  read  only 

^.^3  t_ ..  . x*  ~ _ -v  _ „ ...  •-*  _ ...  j _ 

oxwu  dpcCAiidu  L>y  uiic;  citaidccic  uc JL  uiOi  » ^iidi  id 

taken  from  the  following  set: 
b bos 

u Warm  UNIX 

1 Cold  UNIX 

2 unassigned 

Due  to  their  rarity  of  use,  maki  and  msys  are 
maintained  off  line  and  must  be  reassembled  be- 
fore used. 

/dev/rfO,  /dev/tapn 

/etc/init,  /bin/ tap,  /bin/sh,  /bin/mkdir,  bppt 
format 


The  files  /bin/mount,  /bin/sdate,  and  /bin/date 
should  be  included  in  the  initialization  list  of 
maki . 


OWNER 


ken 
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/ETC/BRT1 , BRT2  (VII ) 

NAME 

brtl , brt2  — B runtime  routines 

SYNOPSIS 

— 

DESCRIPTION 

The  first  of  these  routines  must  be  loaded  first 
in  an  executable  B program;  the  second  must  be 
loaded  last,  after  all  other  routines.  They  are 
not  in  /etc/bilib  only  because  having  them 
separate  is  the  easiest  way  to  assure  the  order 
of  loading. 

FILES 

— 

SEE  ALSO 

b command,  bilib 

DIAGNOSTICS 

— 

BUGS 

— 

OWNER 

Ren 
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/ETC/FI,  F2,  F3 , 

F4  (VII) 

NAME 

fl  , f2,  f 3 , f4  — Fortran  compiler 

SYNOPSIS 

— 

DESCRIPTION 

These  programs  represent  the  four  phases 
Fortran  compilation: 

of  a 

fl : specification  statements 
f2:  common  and  equivalence  allocation 
f 3 : executable  statements 
f4:  cleanup 

Each  exec's  the  next:  the  first  is  called 
for  comma  nd . 

by  the 

FILES 

f.tmpl,  f.tmp2,  f.tmp3 

SEE  ALSO 

for 

DIAGNOSTICS 

— 

BUGS 

Besides  the  fact  that  there  is  a good  deal  of  the 
Fortran  language  missing,  there  is  no  for 

command;  Fortran  is  invoked  via  a command  file. 

UWiNEK 

xen,  dmr 
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/ETC/GLOB  (VII) 


NAME  glob  — global 

SYNOPSIS 

DESCRIPTION  glob  is  used  to  expand  arguments  to  the  shell 

containing  or  ?".  It  is  passed  the  argument 

list  containing  the  metacharacters;  glob  expands 
the  list  and  calls  the  command  itself. 

FILES 

SEE  ALSO  sh 

DIAGNOSTICS  "no  match",  "no  command" 

BUGS  glob  will  onl^  load  a command  from  /bin.  Also  if 

any  or  "?  argument  fails  to  generate 

matches,  "no  match  is  typed  and  the  command  is 
not  executed. 

OWNER  dmr 
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/ETC/INIT  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 


init  — process  initialization 


init  is  invoked  inside  UNIX  as  the  last  step  in 

+-  V>  o Vv~vr>i  f*  nrnno^nro  T 4-  f H y of  r*avv*' i nc  nnf  eoirnral 

*^WW  V W >— ■ >-*  V.  • V X O w *—  VA  i.  A Stf  W V/  M u VV  J.V4X 

housekeeping  duties:  it  must  change  the  modes  of 
the  tape  files  and  the  RK  disk  file  to  17,  be- 
cause if  the  system  crashed  while  a tap  or  rk 
command  was  in  progress,  these  files  would  be 
inaccessible;  it  also  truncates  the  file 
/tmp/utmp,  which  contains  a list  of  UNIX  users, 
again  as  a recovery  measure  in  case  of  a crash. 
Directory  usr  is  assigned  via  sys  mount  as 
resident  on  the  RK  disk. 

init  then  forks  several  times  so  as  to  create  one 
process  for  each  typewriter  channel  on  which  a 
user  may  log  in.  Each  process  changes  the  mode 
of  its  typewriter  to  1 5 (read/write  owner, 
write-only  non-owner;  this  guards  against  random 
users  stealing  input)  and  the  owner  to  the 
super-user.  Then  the  typewriter  is  opened  for 
reading  and  writing.  Since  these  opens  are  for 
the  first  files  open  in  the  process,  they  receive 

^ V>  (Cj  f i 1 a ^ p c i-1  r i r>  f n r rv-^  4 fhia  ^ v,  1 »>,-.+* 

^ VV/*  W V I p W<iW  WVUi  *v^L  Ci  i M X I w 

and  output  file  descriptors.  It  is  likely  that 
no  one  is  dialled  in  when  the  read  open  takes 
place;  therefore  the  process  waits  until  someone 
calls.  At  this  point,  init  types  its  "login:" 
message  and  reads  the  response,  which  is  looked 
up  in  the  password  file.  The  password  file  con- 
tains each  user's  name,  password,  numerical  user 
ID,  default  working  directory,  and  default  shell. 
If  the  lookup  is  successful  and  the  user  can  sup- 
ply his  password,  the  owner  of  the  typewriter  is 
changed  to  the  appropriate  user  ID.  An  entry  is 
made  in  /tmp/utmp  for  this  user  to  maintain  an 
up-to-date  list  of  users.  Then  the  user  ID  of 
the  process  is  changed  appropriately,  the  current 
directory  is  set,  and  the  appropriate  program  to 
be  used  as  the  Shell  is  executed. 

At  some  point  the  process  will  terminate,  either 
because  the  login  was  successful  but  the  user  has 
now  logged  out,  or  because  the  login  was  unsuc- 
cessful. The  parent  routine  of  all  the  children 
of  init  has  meanwhile  been  waiting  for  such  an 
event.  When  return  takes  place  from  the  sys 
wait . init  simply  forks  again,  and  the  child  pro- 
cess again  awaits  a user. 

There  is  a fine  point  involved  in  reading  the 
login  message.  UNIX  is  presently  set  up  to  han- 
dle automatically  two  types  of  terminals:  150 
baud,  full  duplex  terminals  with  the  line-feed 
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/ETC/INIT  (VII) 


FILES 

SEE  ALSO 

DIAGNOSTICS 


function  (typically,  the  Model  37  Teletype  termi- 
nal), and  300  baud,  full  duplex  terminals  with 
only  the  line-space  function  (typically  the  GE 
TermiNet  terminal).  The  latter  type  identifies 
itself  by  sending  a line-break  (long  space)  sig- 


lial  at 


log  x n 


fhV>  rt  VO 

X UCIULUX  | 


* iu  a uv 


ter  is  received  during  reading  of  the  login  line, 
the  typewriter  mode  is  set  to  accommodate  this 
terminal  and  the  "login:”  message  is  typed  again 
(because  it  was  garbled  the  first  time). 


Init,  upon  first  entry,  checks  the  switches  for 
73700.  If  this  combination  is  set,  init  will 
open  /dev/ tty  as  standard  input  and  output  and 
directly  execute  /bin/sh.  In  this  manner,  UNIX 
can  be  brought  up  with  a minimum  of  hardware  and 
software. 


/tmp/utmp,  /dev/ttyO  ...  /dev/ttyn 
sh 

"No  directory",  "No  shell".  There  are  also  some 

halts  if  basic  I/O  files  cannot  be  found  in  ./dev. 


BUGS 


OWNER 


ken,  dmr 
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/ETC/KBD  (VII) 


NAME  kbd  — keyboard  map 

SYNOPSIS  cat  / etc/kbd 

DESCRIPTION  kbd  contains  a map  to  the  keyboard  for  model  37 

Teletype  terminals  with  the  extended  character 
set  feature.  If  kbd  is  printed  on  such  a termi- 
nal, the  following  will  appear: 

< [1  234567890-_J  ~\  >qwertyuiop@  asdfghjkl;  : zxcvbnm,./ 

<V1  234567890— 'djt  > v ;;  ,./ 

<{!"#$%&'()  =_}~!  >QWERTYUIOP ' ASDFGHJKL+*  ZXCVBNM,.? 

< !"#$%&'()  =-*  >£AA^0orcpr0II  ae8<l>r'PitpX+* 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 

OWNER  jfo 
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/ETC/LIBA.A  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


liba.a  — assembly  language  library 


This  library  is  the  standard  location  for 

o c*  om  t r — 1 qi  1 V»  r*/"»  1 1+*  i no  o rtonpral  no  a A 

UUQCIIIWX  jr  uu^C  *~r  vj.  4.  m A %*m  ^ • n 

section  of  this  manual  is  devoted  to  its  con- 
tents. 

This  library  isw searched  when  the  link  editor  Id 
encounters  the  "-l"  argument. 


Id:  library  manual 


OWNER 


dmr,  ken 
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/ETC/LIBB.A  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 


libb.a  — B library 


This  library  contains  all  B-callable  subroutines 

va  1 m*-  •!  1 4 T a.  — i _ _ . < 

wa.  wlxx  _l.  ty  # x us  uu u ut=  nt. t>  ar«  nerai  i pn  u 

the  library  section  of  the  B manual, 
its  contents  are: 


At  present 


char 

getchr 

putchr 

exit 

printf 

seek 

setuid 

stat 

time 

unlink 

wait 

lchar 

chdir 

chmod 

chown 

close 

Cr  Bel  t. 

execl 

execv 

fork 

f stat 

getuid 

intr 

link 

makdir 

open 

read 

write 

ctime 


FILES 

SEE  ALSO  b 

DIAGNOSTICS 


BUGS 


OWNER 


ken,  dmr 
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LIBF.A  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


/etc/libf.a  — Fortran  library 


This  library  contains  all  the  Frotran  runtime 
routines.  Many  are  missing. 


■f=1  FO  FI  FA 


Will  be  renamed,  and  libf .a  reserved  for 
subroutines  and  functions. 

ken,  dmr 


OWNER 
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LOGIN,  LOGOUT  (VII ) 


NAME 

SYNOPSIS 

DESCRIPTION 


logging  in  and  logging  out 


UNIX  must  be  called  from  an  appropriate  terminal. 
The  two  general  classes  of  terminals  which  UNIX 
supports  are  typified  by  the  37  Teletype  on  the 
one  hand  and  the  GE  TermiNet  300  and  Memorex  1240 
on  the  other.  The  principal  difference  is  the 


a f A C r\  /~v  \ _ _ ,3  T j_  ^ ^ -i „ x-  _ .c  4_  -u.  — 

wwuu  laic  v * vo#  ouu;  anu  uuc  ucauucm,  ui  uic 

carriage  return  character.  Most  terminals 
operating  at  150,  300,  or  1200  baud  using  the 
ASCII  character  set  either  work  (more  or  less)  at 
the  moment  or  can  be  used  by  special  arrangement. 
In  particular,  special  arrangement  is  necessary 
for  terminals  which  do  not  generate  lower-case 
ASCII  characters. 


It  is  also  necessary  to  have  a valid  UNIX  user  ID 
and  (if  desired)  password.  These  may  be  ob- 
tained, together  with  the  telephone  number,  from 
the  system  administrators. 

The  same  telephone  number  serves  terminals 
operating  at  both  the  standard  speeds.  When  a 
connection  is  established  via  a 150-baud  terminal 
(e.g.  TTY  37)  UNIX  types  out  "login:";  you 
respond  with  your  user  name,  and,  if  a mask  is 
typed,  with  aMpassword.  If  the  login  was  suc- 
cessful, the  "§"  character  is  typed  by  the  Shell 
to  indicate  login  is  complete  and  commands  may  be 
issued.  A message  of  the  day  may  be  typed  if 
there  are  an^  announcements.  Also,  if  there  is  a 
file  called  mailbox",  you  are  notified  that 
someone  has  sent  you  mail.  (See  the  mall  com- 
mand. ) 

From  a 300-baud  terminal,  the  procedure  is 
slightly  different.  Such  terminals  often  have  a 
full-duplex  switch,  which  should  be  turned  on  (or 
conversely,  half-duplex  should  be  turned  off) . 
When  a connection  with  UNIX  is  established,  a few 
garbage^ characters  are  typed  (these  are  the 
login:"  message  at  the  wrong  speed).  You  should 
depress  the  "break"  key;  this  is  a speed- 
independent  signal  to  UNIX  that  a 300— baud  termi- 
nal is  in  use.  It  will  type  "login:"  (at  the 
correct  speed  this  time)  and  from  then  on  the 
procedure  is  the  same  as  described  above. 

Logging  out  is  simple  by  comparison  (in  fact, 
sometimes  too  simple) . Simply  generate  an  end- 
of-file  at  Shell  level^by  using  the  EOT 
character;  the  "login:"  message  will  appear  again 
to  indicate  that  you  may  log  in  again. 
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LOGIN,  LOGOUT  (VIl) 


It  is  also  possible  to  log  out  simply  by  hanging 
up  the  terminal;  this  simulates  an  end-of-file  on 
the  typewriter. 


FILES 
SEE  ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


init 


Hanging  up  on  programs  which  never  read  the  type- 
writer or  which  ignore  end-of-files  is  very 
dangerous;  in  the  worst  cases,  the  programs  can 
only  be  halted  by  restarting  the  system. 

ken,  dmr 
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/ETC/MSH  (VII) 


NAME  msh  — mini-shell 

SYNOPSIS 

DESCRIPTION  msh  is  a heavily  simplified  version  of  the  Shell. 

It  reads  one  line  .from  the  standard  input  file, 
interprets  it  as  a command,  and  calls  the  com- 
mand. 

The  mini-shell  supports  few  of  the  advanced 
features  of  the  Shell;  none  of  the  following 
characters  is  special : 

> < $ \ 5 & 

However,  and  "?"  are  recognized  and  glob  is 

called.  The  main  use  of  msh  is  to  provide  a 
command-executing  facility  for  various  interac- 
tive sub- systems. 

FILES 

SEE  ALSO  sh,  glob 

DIAGNOSTICS  "?" 

BUGS 


OWNER 


ken,  dmr 
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/ETC/SUFTAB  (VII) 


NAME  suftab  — suffix  table 

SYNOPSIS  — 

DESCRIPTION  suftab  is  a table  of  suffixes  used  to  guide 

hyphenation  in  rof  f . Its  first  12  words  are  not 
used  (see  a. out  format.)  Its  next  26  words  point 
to  the  beginning  of  the  subtables  for  each  of  the 
26  initial  letters  of  a suffix.  The  first  entry 
for  each  suffix  is  a count  of  the  number  of  bytes 
in  the  suffix.  The  second  byte  of  each  entry  is 
a flag  indicating  the  type  of  suffix.  The  suffix 
itself  follows;  the  high  bits  of  each  letter 
indicate  where  the  hyphens  come.  The  table  for 
each  initial  suffix  letter  ends  with  a zero  count 
byte. 

FILES 

SEE  ALSO  roff 

DIAGNOSTICS 

BUGS 

OWNER  jto,  dmr,  Ken 
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/ETC/ TABS  (VII) 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 

SEE  ALSO 

DIAGNOSTICS 

BUGS 

OWNER 


tabs  — tab  stop  set 
cat  /etc/tabs 

When  printed  on  a suitable  terminal,  this  file 
will  set  tab  stops  at  columns  8,  16,  24,  32,  .... 
Suitable  terminals  include  the  Teletype  model  37 
and  the  GE  TermiNet  300. 

Since  UNIX  times  delays  assuming  tabs  set  every 
8,  this  has  become  a defacto  'standard.' 


ken 


